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PREFACE 


This manual assumes the user has read the Atari BASIC — A Self-Teaching 
Guide or some other book on BASIC. This manual is not intended to “teach” 
BASIC. It is a reference guide to the commands, Statements, functions, and 
special applications of Atari® BASIC. 

The programs and partial programming examples used in this manual are 
photostats of listings printed on the Atari 820™ Printer. Some of the special Sym¬ 
bols in the Atari character set do not appear the same on the printer; e.g., the 
clear screen Symbol appears as a “ The examples in the text were 

chosen to illustrate a particular function — not necessarily “good” programming 
techniques. 

Each of the sections contains groups of commands, functions, or Statements 
dealing with a particular aspect of Atari BASIC. For instance, Section 9 contains 
all the Statements pertaining to Atari’s unique graphics capabilities. The appen- 
dices include quick references to terms, error messages, BASIC keywords, 
memory locations, and the ATASCII Character set. 

As there is no one specified application for the Atari Personal Computer System, 
this manual is directed at general applications and the general user. Appendix H 
contains programs that illustrate a few of the Atari system’s capabilities. 
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TERMIN OLOG Y 


GENERAL 

INFORMATION 


This section explains BASIC terminology, special notations, and abbreviations 
used in this manual, and the special keys on the ATARI 400™ and ATARI 800™ 
Personal Computer Systems keyboard. It also points to other sections where 
BASIC commands deal with specific applications. 


BASIC: Beginner’s All-purpose Symbolic Instruction Code. 


BASIC Keyword: Any reserved word “legal” in the BASIC language. May be 
used in a Statement, as a command, or for any other purpose. (See Appendix A 
for a list of all “reserved words” or keywords in ATARI BASIC.) 


BASIC Statement: Usuallv begins with a keyword, like LET, PRINT, or 
RUN. 


Constant: A constant is a value expressed as a number rather than represented 
by a variable name. For example, in the Statement X = 100, X is a variable and 
100 is a constant. (See Variable.) 


Command String: Multiple commands (or program Statements) placed on the 
same numbered line separated by colons. 


Expression: An expression is any legal combination of variables, constants, 
operators, and functions used together to compute a value. Expressions can be 
either arithmetic, logical, or string. 


Function: A function is a computation built into the Computer so that it can be 
called for by the user’s program. A function is NOT a Statement; it is part of an 
expression. It is really a subroutine used to compute a value which is then 
“returned” to the main program when the subroutine returns. COS (Cosine), 
RND (random), FRE (unused memory space), and INT (integer) are examples of 
functions. In many cases the value is simply assigned to a variable (stored in a 
variable) for later use. In other cases it may be printed out on the screen im- 
mediately. See Section 6 for more on functions. Examples of functions as they 
might appear in programs are: 


10 PRINT RNDC0) 

(print out the random 
number returned) 

10 >v=100+COSt 45> 

(add the value re- 
returned to 100 and 
störe the total in 
variable X) 


General Information 1 




If the screen displays an ERROR-4 (Too Many Variables) message, use the follow- 
ing procedure to make room for new variable names: 

LIST filespec 
NEW 

ENTER fi1espec 

The LIST filespec writes the untokenized version of the program onto a disk or 
cassette. NEW clears the program and the table areas. The program is then re- 
entered, re-tokenized, and a new variable table is built. (The tokenized version 
is Atari BASIC’s internal format. The untokenized versions in ATASCII 
which is the version displayed on the screen). 

Arrays and Array Variables: An array is a list of places where data can be 
filed for future use. Each of these places is called an element, and the whole array 
or any element is an array variable. For example, define “Array A” as having 6 
elements. These elements are referred to by the use of subscripted variables 
such as A(2), A(3), A(4), etc. A number can be stored in each element. This 
may be accomplished element by element (using the LET Statement), or as a part 
of a FOR/NEXT loop (see Chapter 8). 

Note: Never leave blanks between the element number in parentheses and the 
name of the array. 


Correct 


Incorrect 


A(23) 

ARRAYC3) 

X123C38) 


A (23) 

ARRAY (3) 

X123 (38) 


SPECIAL 
NOTATIONS 
USED IN THIS 
MANUAL 


Line Format: The format of a line in a BASIC program includes a line number 
(abbreviated to lineno) at the beginning of the line, followed by a Statement 
keyword, followed by the body of the Statement and ending with a line ter- 
minator command (tamukey). In an actual program, the four elements might 
look like this: 


Line Number 
100 


STATEMENT 


Keyword Body 

PRINT A/X * (Z +4.567) 


Terminator 


RETURN 


Several Statements can be typed on the same line provided they are separated by 
colons (:). See IF/THEN in Section 5, and Section 11. 

Capital Letters: In this book, denote keywords to be typed by the user in up- 
per case form exactly as they are printed in this text. Reverse-video characters 
will not work except in the case of the RUN command. Here are a few ex- 
amples: 

PRINT INPUT LIST END GOTO GOSUB FOR NEXT IF 


Lower Case Letters: In this manual, lower case letters are used to denote the 
various classes of items which may be used in a program, such as variables 
(var), expressions (exp), and the like. The abbreviations used for these classes of 
items are shown in Table 1.1. 
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sexp 


exp 

lineno 


adata 


filespec 


String Expression: Can consist of a string variable, string literal 
(constant), or a function that returns a string value. 

Any expression, whether sexp or aexp. 

Line Number: A constant that identifies a particular program 
line in a deferred mode BASIC program. Must be any integer 
from 0 through 32767. Line numbering determines the order of 
program execution. 

ATASCII Data: Any ATASCII character excluding commas and 
carriage returns. (See Appendix C.) 

File Specification: A string expression that refers to a device 
such as the keyboard or to a disk file. It contains information on 
the type of I/O device, its number, a colon, an optional file name, 
and an optional filename extender. (See OPEN, Section 5.) 

Example filespec: “Dl.-NATALIE.ED” 


OPERATING 

MODES 


Direct Mode: Uses no line numbers and executes instruction immediately after 
ESm key is pressed. 


Deferred Mode: Uses line numbers and delays execution of instruction(s) until 
the RUN command is entered. 


Execute Mode: Sometimes called Run mode. After RUN command is entered, 
each program line is processed and executed. 

Memo Pad Mode: A non-programmable mode that allows the user to experi- 
ment with the keyboard or to leave messages on the screen. Nothing written 
while in Memo Pad mode affects the RAM-resident program. 


SPECIAL 

FUNCTION 

KEYS 



Reverse (Inverse) Video key, or “ATARI LOGO KEY”. Press¬ 
ing this key causes the text to be reversed on the screen (dark 
text on light background). Press key a second time to return to 
normal text. 


CAPS/LOWR 


Lower Case key: Pressing this key shifts the screen characters 
from upper case (capitals) to lower case. To restore the characters 
to upper case, press the key and the key 

simultaneously. 


Escape key: Pressing this key causes a command to be entered 
into a program for later execution. 

Example: To clear the screen, you would enter: 

io print “ reg tarn | 


and press 


RETURN 


Escape is also used in conjunction with other keys to print special 
graphic control characters. See Appendix F and back cover for 
the specific keys and their screen-character representations. 
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AND Logical AND 

OR Logical OR 

Examples: 

10 IF A=12 AMD T=0 THEH PRINT 

10 A=(C>1) AMD (N< 1) 

10 A = (C+l > OR (M-l) 

10 A = NOK C+l) 


,! G00 r|1 ’ Both expressions must 
be true before GOOD is 
printed. 

Ifboth expressions 
true, A = +1; otherwise 
A=0. 

If eit her expression 
true, A= +1; otherwise 
A=0. 

If expression isfalse, 
A= +1; otherwise A = 0. 


The rest of the binary operators are relational. 

< The first expression is less than the second expression. 

> The first expression is greater than the second. 

= The expressions are equal to each other. 

< = The first expression is less than or equal to the second. 

> = The first expression is greater than or equal to the second. 

< > The two expressions are not equal to each other. 

These operators are most frequently used in IF/THEN Statements and logical 
arithmetic. 


OPERATOR 

PRECEDENCE 


Operations within the innermost set of parentheses are performed first and pro- 
ceed out to the next level. When sets of parentheses are enclosed in another set, 
they are said to be “nested”. Operations on the same nesting level are performed 
in the following Order: 


Highest <,>, = ,< 
precedence 


* 


,/ 


<>>> = ;< 

NOT 

AND 

Lowest OR 

precedence 


>■=>■<■->■ Relational operators used in string expres¬ 
sions. Have same precedence and are per¬ 
formed from left to right. 

Unary minus 
Exponentiation. 

Multiplication and division have the same 
precedence level and are performed from left 
to right. 

Addition and subtraction have the same 
precedence level and are performed from left 
to right. 

>=,< > Relational operations in numeric expressions 
have the same precedence level from left to 
right. 

Unary operator 
Logical AND 
Logical OR 
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COMMANDS 


Whenever the Cursor (□) is displayed on the screen, the Computer is ready to ac- 
cept input. Type the command (in either Direct or Deferred mode), and press 
1332323 ■ This section describes the commands used to clear Computer memory 
and other useful control commands/ 

The commands explained in this section are the following: 


BYE 

NEW 

CONT 

REM 

END 

RUN 

LET 

STOP 

LIST 



BYE (B.) Format: BYE 

Example: BYE 

The current function of the BYE command is to exit BASIC and put the Com¬ 
puter in Memo Pad mode. This allows the user to experiment with the keyboard 
or to leave messages on the screen without disturbing any BASIC program in 
memory. To return to BASIC, press • 

CONT (CON.) Format: CONT 

Example: CONT 

Typing this comm and followed by a l;l=WU:l!l causes program execution to 
resume. If a B353I , STOP, or END is encountered, the program will stop until 
CONT Q32339 is entered. Execution resumes at the next sequential line number 
following the Statement at which the program stopped. 

Note: If the Statement at which the program is halted has other comm ands on 
the same numbered line which were not executed at the time of the , 

STOP, or END, they will not be executed. On CONT, execution resumes at the 
next numbered line. A loop may be incorrectly executed if.the program is 
halted before the loop completes execution. 

This command has no effect in a Deferred mode program. 

END Format: END 

Example: 1000 END 

This command terminates program execution and is used in Deferred mode. In 
Atari BASIC, an END is not required at the end of a program. When the end of 
the program is reached, Atari BASIC automatically closes all files and turns off 
sounds (if any). END may also be used in Direct mode to close files and turn off 
sounds. 


Commands 9 




RUN (RU.) Format: RUN [filespec] 

Examples: RUN 

RUN “D:MENU” 

This command causes the Computer to begin executing a program. If no filespec 
is specified, the current RAM-resident program begins execution. If a filespec is 
included, the Computer retrieves the specified, tokenized program from the 
specified file and executes it. 

All variables are set to zero and all open files and peripherals are closed. All ar- 
rays, strings, and matrices are eliminated and all sounds are turned off. Unless 
the TRAP command is used, an error message is displayed if any error is 
detected during execution and the program halts. 

RUN can be used in Deferred mode. 

Examples: 10 PRIKT "OUER AND ODER AGAIN." 

20 RUN 

Type RUN and press . To end, pressESS- 

To begin program execution at a point other than the first line number, type 
GOTO followed by the specific line number, then press fiTo'J:ei . 

STOP (STO.) Format: STOP 

Example: 100 STOP 

When the STOP command is executed in a program, BASIC displays the 

message STOPPED AT LINE _ , terminates program execution, and 

returns to Direct mode. The STOP command does not close files or turn off 
sounds, so the program can be resumed by typing CONT . 
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EDIT 

FEATURES 


In addition to the special function keys described in Section 1, there are Cursor 
control keys that allow immediate editing capabilities. These keys are used in 
conjunction with the or GEB keys. 

The following key functions are described in this section: 



GEB BSEB 

l 


GEB 

GEB 2 

GEB □ 


GEB 3 

GEB □ 



GEB o 

GEB D 




SCREEN 

EDITING 


The keyboard and display are logically combined for a mode of Operation 
known as screen editing. Each time a change is completed on the screen, the 
QGSD key must be pressed. Otherwise, the change is not made to the program 
in RAM. 


Example: 1U REM HREoC ElTUkN RFThR LI Nh hOiT 
28 PRINT --PRINT 

38 PRINT "THIS IS LINE 1 ON THE SCREEN. 


To delete line 20 from the program, type the line number and press the Q3QEI 
key. Merely deleting the line from the screen display does not delete it from the 
program. 

The screen and keyboard as I/O devices are described in Section 5. 

GEB Control key. Striking this key in conjunction with 

the arrow keys produces the Cursor control functions 
that allow the user to move the Cursor anywhere on 
the screen without changing any characters already 
on the screen. Other key combinations control the 
setting and Clearing of tabs, halting and restarting 
program lists, and the graphics control Symbols. 
Striking a key while holding the GEB key will pro- 
duce the upper-left Symbol on those keys having 
three functions. 

Shift key: This key is used in conjunction with the 
numeric keys to display the Symbols shown on the 
upper half of those keys. It is also used in conjunction 
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FOR (F.), TO, 
STEP/NEXT (N.) 


PROGRAM 

STATEMENTS 


This section explains the commands associated with loops, conditional and un- 
conditional branches, error traps, and subroutines and their retrieval. It also ex¬ 
plains the means of accessing data and the optional command used for defining 
variables. 

The following commands are described in this section: 

FOR, TO, STEP/NEXT IF/THEN POP 

GOSUB/RETURN ON, GOSUB RESTORE 

GOTO ON, GOTO TRAP 


Format: FOR avar = aexpl TO aexp2 [STEP aexp3] 

NEXT avar 

Examples: FOR X = 1 TO 10 
NEXT X 

FOR Y = 10 TO 20 STEP 2 
NEXT Y 

FOR INDEX = Z TO 100 * Z 
NEXT INDEX 

This command sets up a loop and determines how many times the loop is exe- 
cuted. The loop variable (avar) is initialized to the value of aexpl. Each time the 
NEXT avar Statement is encountered, the loop variable is incremented by the 
aexp3 in the STEP Statement. The aexp3 can be positive or negative integers, 
decimals, or fractional numbers. If there is no STEP aexp3 command, the loop 
increments by one. When the loop completes the limit as defined by aexp2, it 
stops and the program proceeds to the Statement immediately following the 
NEXT Statement; it may be on the same line or on the next sequential line. 

Loops can be nested, one within another. In this case, the innermost loop is com- 
pleted before returning to the outer loop. The following example illustrates a 
nested loop program. 


10 FÜR X=1 TO 3 
20 PRINT "OUTER LOOP" 

30 2=0 
40 2=2+2 

58 FOR Y=1 TO 5 STEP 2 
60 PRINT " INNER LOOP" 
70 NEXT Y 
80 NEXT X 
90 END 


Figure 4-1. Nested Loop Program 
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GOTO (G.) 


To prevent accidental triggering of a subroutine (which normally follows the 
main program), place an END Statement preceding the subroutine. The follow- 
ing program demonstrates the use of subroutines. 


lfl pp INT "V 

20 REM EXANPLE USE OF GOSUB/RETURN 
38 3=188 


48 

GOSUB 1.000 

58 

3=120 

fci@ 

GOSUB 1080 

78 

3=58 

Om 

i_rrj 

GOSUB 108G 

90 

END 


1000 V=3TM 

1010 x=x+v 

1928 PRINT 
1038 RETURN 


(Clear screen) 


Figure 4-3. GOSUB/RETURN Program Listing 


In the above program, the subroutine, beginning at line 1000, is called three 
times to compute and print out different values of X and Y. Figure 4-4 illustrates 
the results of executing this program. 


400 388 
480 360 
200 150 


Figure 4-4. GOSUB/RETURN Program Run 


Format: j GO TO 1 aexp 

Igoto | 

Examples: 100 GOTO 50 

500 GOTO (X + Y) 


The GOTO command is an unconditional branch Statement just like the GOSUB 
command. They both immediately transfer program control to a target line 
number or arbitrary expression. However, using anything other than a con- 
stant will make renumbering the program difficult. If the target line number is 
non-existent, an error results. Any GOTO Statement that branches to a 
preceding line may result in an “endless” loop. Statements following a GOTO 
Statement will not be executed. Note that a conditional branching Statement (see 
IF/THEN)can be used to break out of a GOTO loop. The following program il¬ 
lustrates two uses of the GOTO command. 
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The IF/THEN Statement is a conditional branch Statement. This type of branch 
occurs only if certain conditions are met. These conditions may be either 
arithmetical or logical. If the aexp following the IF statement is true (non-zero), 
the program executes the THEN part of the statement. If, however, the aexp is 
false (a logical 0), the rest of the statement is ignored and program control passes 
to the next numbered line. 


In the format, IF aexp THEN lineno, lineno must be a constant, not an expression 
and specifies the line number to go to if the expression is true. If several 
Statements occur after the THEN, separated by colons, then they will be ex- 
ecuted if and only if the expression is true. Several IF Statements may be nested 
on the same line. For example: 


100 IF X=5 THEN IF Y=3 THEN R=9 = GÖ1 


The Statements R = 9: GOTO 100 will be executed only if X = 5 and Y = 3. The 
statement Y = 3 will be executed if X = 5. 

The following program demonstrates the IF/THEN statement. 


GRAPHICS 8 : ? 


IF DEMO" 


10 ? :? "ENTER A";:INPUT A 

20 IF A=1 THEN 40=REH MULTIPLE STATEMENT 

S HERE WILL NEUER BE EXECUTED! ! 

30 ? :? "A IS NOT 1. EXECUTION CONTI ILE 
S HERE WHEN THE EXPRESSION IS FALSE." 

48 IF A=1 THEN ? =? "A=l"=? "YES, IT IS 
REAL.LY 1." ; REM MULTIPLE STATEMENTS HERE 
WILL BE EXECUTED ONLY IF A=1i! 


5ü ? 


EXECUTION CONTINUES HERE IF A<> 


1 OR AFTER ‘YES, IT IS REALLY 1' IS DISP 
LAYED." 

68 GOTO 10 


Figure 4-7. IF/THEN Program 


ENTER A (entered 2) 

A IS NOT 1. EXECUTION CÜNTINUES HERE WH 
EN THE EXPRESSION IS FALSE. 

EXECUTION CONTINLES HERE IF AOl OR AFTE 
R 'YES, IT IS REALLY 1' IS DISPLAYED. 

ENTER A (entered 1) 


A=1 

YES, IT IS REALLY 1. 

EXECUTION CONTINUES HERE IF AOl OR AFTE 
R 'YES, IT IS REALLY 1' IS DISPLAYED. 
ENTER A 


Figure 4-8. IF/THEN Program Execution. 
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RESTORE (RES.) 


In the description of the FOR/NEXT Statement, the stack was defined as a group 
of memory addresses reserved for return addresses. The top entry in the stack 
Controls the number of loops to be executed and the RETURN target line for a 
GOSUB. If a subroutine is not terminated by a RETURN Statement, the top 
memory location of the stack is still loaded with some numbers. If another 
GOSUB is executed, that top location needs to be cleared. To prepare the stack 
for a new GOSUB, use a POP to clear the data from the top location in the stack. 

The POP command must be used according to the following rules: 

1. It must be in the execution path of the program. 

2. It must follow the execution of any GOSUB Statement that is not brought 
back to the main program by a RETURN Statement. 

The following example demonstrates the use of the POP command with a 
GOSUB when the RETURN is not executed: 


10 GOSUB 1080 

15 REM LIME 20 WILL HOT BE EXECUTED 
20 PRINT "NORMAL RETURN PRINTS THIS MESS 
AGE." 

30 PRINT "ABNORMAL RETURN PRINTS THIS ME 
SSAGE." 

40 POP 
999 EMO 

1008 PRINT "NOW EXECUTING SUBROUTINE." 
1810 GOTO 38 
1028 RETURN 


Figure 4-11. GOSUB Statement With POP 

Format: RESTORE [aexp] 

Example: 100 RESTORE 

The Atari Personal Computer System contains an internal “pointer” that 
keeps track of the DATA Statement item to be read next. Used without the op¬ 
tional aexp, the RESTORE Statement resets that pointer to the first DATA item 
in the program. Used with the optional aexp, the RESTORE Statement sets the 
pointer to the first DATA item on the line specifed by the value of the aexp. This 
Statement permits repetitive use of the same data. 


18 FOR N=1 TO 2 
28 READ A 
30 RESTORE 
40 READ B 
50 M=A+B 

60 PRINT "TOTAL EQUALS ";M 
70 NEXT N 
88 END 

90 DATA 30; 15 

Figure 4-12. Restore Program Listing 

On the first pass through the loop, A will be 30 and B will be 30 so the total line 
50 will print SUM TOTAL EQUALS 60, but on the second pass, A will equal 15 
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INPUT/OUTPUT 
COMMANDS AND DEVICES 


This section describes the input/output devices and how data is moved between 
them. The commands explained in this section are those that allow access to the 
input/output devices. The input commands are those associated with getting 
data into the RAM and the devices geared for accepting input. The output com¬ 
mands are those associated with retrieving data from RAM and the devices 
geared for generating output. 

The commands described in this section are: 


CLOAD 

INPUT 

OPEN/CLOSE 

READ/DATA 

CSAVE 

LOAD 

POINT 

SAVE 

DOS 

LPRINT 

PRINT 

STATUS 

ENTER 

INPUT/OUTPUT 

NOTE 

PUT/GET 

XIO 


DEVICES The hardware configuration of each of the following devices is illustrated in the 

individual manuals furnished with each. The Central Input/Output (CIO) Sub¬ 
system provides the user with a single interface to access all of the System 
peripheral devices in a (largely) independent manner. This means there is a 
single entry point and a device-independent calling secjuence. Each device has a 
symbolic device name used to identify it; e.g., K: for the keyboard. Each device 
must be opened before access and each must be assigned to an Input/Output Con¬ 
trol Block (IOCB). From then on, the device is referred to by its IOCB number. 

ATARI BASIC contains 8 blocks in RAM which identifies to the Operating 
System the Information it needs to perform an I/O Operation. This information 
includes the command, buffer length, buffer address, and two auxiliary control 
variables. ATARI BASIC sets up the IOCB’s, but the user must specify which 
IOCB to use. BASIC reserves IOCB #0 for I/O to the Screen Editor, therefore the 
user may not recjuest IOCB #0. The GRAPHICS Statement (see Section 9) opens 
IOCB #6 for input and output to the screen. (This is the graphics window S:). 
IOCB #7 is used by BASIC for the LPRINT, CLOAD, and CSAVE commands. The 
IOCB number may also be referred to as the device (or file) number. IOCB’s 1 
through 5 are used in opening the other devices for input/output operations. If 
IOCB #7 is in use, it will prevent LPRINT or some of the other BASIC I/O 
Statements from being performed. 

Keyboard: (K:) Input only device. The keyboard allows the user to read the 
converted (ATASCII) keyboard data as each key is pressed. 

Line Printer: (P:) Output only device. The line printer prints ATASCII 
characters, a line at a time. It recognizes no control characters. 

Program Recorder: (C:) Input and Output device. The recorder is a read/write 
device which can be used as either, but never as both simultaneously. The 
cassette has two tracks for sound and program recording purposes. The audio 
track cannot be recorded from the ATARI system, but may be played back 
through the television Speaker. 
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DOS (DOJ 


Format: DOS 

Example: DOS 


The DOS command is used to go from BASIC to the Disk Operating System 
(DOS). If the Disk Operating System has not been booted into memory, the Com¬ 
puter will go into Memo Pad mode and the user must press to return 

to Direct mode. If the Disk Operating System has been booted, the DOS Menu is 
displayed. To clear the DOS Menu from the screen, press yüüJiläSJ. Control 
then passes to BASIC. Control can also be returned to BASIC by selecting B (Run 
Cartridge) on the DOS Menu. 

The DOS command is usually used in Direct mode; however, it may be used in a 
program. For more details on this, see the Atari DOS Manual. 

ENTER (E.) Format: ENTER filespec 

Examples: ENTER “C 

ENTER “D:DEMOPR.INS” 

This Statement causes a cassette tape to play back a program originally recorded 
using LIST (see Section 2, LIST). The program is entered in unprocessed (un- 
tokenized) form, and is interpreted as the data is received. When the loading is 
complete, it may be run in the normal way. The ENTER command may also be 
used with the disk drive. Note that both LOAD and CLOAD (see Section 2) clear 
the old program from memory before loading the new one. ENTER merges the 
old and new programs. This ENTER Statement is usually used in Direct mode. 

INPUT (I.) Format: INPUT [#aexp (;)]( svar ) ( svar j J 

Examples: 100 INPUT X 
100 INPUT N$ 

100 PRINT “ENTER THE VALUE OF X” 

110 INPUT X 

This Statement requests keyboard data from the user. In execution, the Com¬ 
puter displays a ? prompt when the program encounters an INPUT Statement. It 
is usually preceded by a PRINT Statement that prompts the user as to the type of 
information being requested. 

String variables are allowed only if they are not subscripted. Matrix variables 
are not allowed. 

The #aexp is optional and is used to specify the file or device number from 
which the data is to be input (see Input/Output Devices). If no ffaexp is specified, 
then input is from the screen editor (E:). 

If several Strings are to be input from the screen editor, type one string, press 
, type the next string, ■agnia« , etc. Arithmetic numbers can be typed on 
the same line separated by comraas. 

10 PRINT "ENTER 5 NUMBERS TO BE SUNNEB" 

20 FÜR H=! TO 5 
30 INPUT X 
40 C=C+X 
58 NEXT N 

68 PRINT "THE SUM OF YOUR NUMBERS IS ";C 
70 END 

Figure 5-1 Input Program Listing 
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aexpl Code number to determine input or output Opera¬ 

tion. 

Code 4 = input Operation 

8 = output Operation 

12 = input and output Operation 
6 = disk directory input Operation 

(In this case, the filespec is the search specifica- 
tion.) 

9 = end-of-file append (output) Operation. Append is 

also used for a special screen editor input mode. 
This mode allows a program to input the next 
line from E: without waiting for the user to press 


aexp2 Device-dependent auxiliary code. An 83 in this 

parameter indicates sideways printing on a printer 
(see appropriate manuals for control codes). 

filespec Specific file designation. Must be enclosed in quota- 
tion marks. The format for the filespec parameter 
is shown in Figure 5-2. 


“D1:ATARI800.BAS” 



characters- 
must begin 
with alphabetic 
character) 


* 


Period required - 
as Separator if 
extender is used. 

Extender — 

(optional)- 

Includes 

0-3 characters 


Note: Filenames a r e 
not used with 
the program 
recorder. 


Figure 5-2 Filename Breakdown 

The CLOSE command simply closes flies that have been previously opened with 
an OPEN command. Note in the example that the aexp following the mandatory 
# character must be the same as the aexp reference number in the OPEN State¬ 
ment. 
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SAVE (S.) 


STATUS (ST.) 


XIO (X.) 


in the program, but must contain as many pieces of data as there are defined in 
the READ Statement. Otherwise, an “out of data” error is displayed on the 
screen. 

String variables used in READ Statements must be dimensioned and cannot be 
subscripted. (See STRINGS Section). Neither may array variables may be used in 
a READ Statement. 

The DATA Statement holds a number of string data for access by the READ 
Statement. It cannot include arithmetical operations, functions, etc. Further- 
more, the data type in the DATA Statement must match the variable type de¬ 
fined in the corresponding READ Statement. 

The following program totals a list of numbers in a DATA Statement: 


10 

FOR N=1 

TO 

CT 

20 

READ D 



30 

ri=n+D 



40 

HEXT N 



50 

PRINT ■ 

sun 

TOTAL EQUAL: 

60 

END 



70 

DATA 30 

, 15, 

106,17,37 


Figure 5-3 Read/Data Program Listing 

The program, when executed, will print the Statement: 

SUM TOTAL EQUALS 255. 


Format: SAVE filespec 

Example: SAVE “Dl:YVONNE.PAT” 

The SAVE command is similar to the CSAVE command except that the full file 
name System can be used. The device code number is optional when using only 
one disk drive. The default is to disk drive #1. SAVE, like LOAD, uses long inter- 
record gaps on the cassette (see CSAVE) and the tokenized form of the program. 


Format: STATUS #aexp,avar 

Example: 350 STATUS #1 ,Z 

The STATUS command calls the STATUS routine for the specified device (aexp). 
The Status of the STATUS command (see ERROR MESSAGES, Appendix B) is 
stored in the specified variable (avar). This may be useful for future devices such 
as the RS-232 interface. 


Format: XIO cmdno, #aexp, aexpl, aexp2, filespec 

Example: XIO 18,#6,0,0,“S:” 

The XIO command is a general input/output Statement used for special opera¬ 
tions. One example is its use to fill an area on the screen between plotted points 
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To execute a “chained” program, use the following steps: 

1. Cue the tape to the beginning of part 1 of the program. 

2. Press PLAY button on the recorder. 

3. Type RUN“C:” . 

4. When the “beep” sounds, press CSJEJI again. 

The Computer automatically loads the first part of the program, runs it, and 
sounds a “beep” to indicate when to hit the space bar or ESZEU to trigger the 
tape motor for the second LOAD/RUN. The loading takes a few seconds. 

Note: A one-part program can be recorded and reloaded in the same way or 
CSAVE and CLOAD can be used. 


Note: Remember to boot DOS before typing in your program. 

MODIFYING A The procedure for modifying an existing BASIC program stored on a diskette is 
PROGRAM demonstrated in the following steps: 

ON DISK -p Turn off ATARI console and insert BASIC cartridge. 

2. Connect disk drive and turn it on - without inserting diskette. 

3. Wait for Busy Light to go out and for the drive to stop. Open disk drive door. 

4. Insert diskette (with DOS) and close door. 

5. Turn on console. DOS should boot in and the screen show READY. 

6. To load program from disk, type 

LOAD “D:filename.ext 

7. Modify program (or type in new program). 

8. To save program on disk, type 

SAVE “D:filename.ext 

9. Always wait for the Busy light to go out before removing diskette. 

10. To get a Directory listing, do not remove diskette and type 

_ DOS 

Upon } the DOS Menu will be displayed. Select command letter A, 

type it, and press ■a=im;e« twice to list the directory on the screen; or type A 
followed by pressing GSEJJthen P: 133333 to list directory on the printer. 

11. To return to BASIC, type B or press ESEH3331 • 
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6 


ARITHMETIC 

FUNCTIONS 

ABS 


CLOG 


EXP 


INT 


FUNCTION 

LIBRARY 


This section describes the arithmetic, trigonometric, and special purpose func- 
tions incorporated into the ATARI BASIC. A function performs a computation 
and returns the result (usually a number) for either a print-out or additional 
computational use. Included in the trigonometric functions are two Statements, 
radians (RAD) and degrees (DEG), that are frequently used with trigonometric 
functions. Each function described in this section may be used in either Direct 
or Deferred mode. Multiple functions are perfectly legal. 

The following functions and Statements are described in this section: 


ABS 

ATN 

ADR 

CLOG 

COS 

FRE 

EXP 

SIN 

PEEK 

INT 

DEG/RAD 

POKE 

LOG 


USR 

RND 



SGN 



SQR 




Format: ABS(aexp) 

Example: 100 AB = ABS (-190) 

Returns the absolute value of a number without regard to whether it is positive 
or negative. The returned value is always positive. 


Format: CLOG (aexp) 

Example: 100 C = CLOG(83) 

Returns the logarithm to the base 10 of the variable or expression in paren- 
theses. CLOG(O) should give an error and CLOG(l) should be 0. 


Format: EXP (aexp) 

Example: 100 PRINT EXP(3) 

Returns the value of e (approximately 2.71828283), raised to the power specified 
by the expression in parentheses. In the example given above, the number 
returned is 20.0855365. In some cases, EXP is accurate only to six significant 
digits. 


Format: INT (aexp) 

Examples: 100 I = INT(3.445) (3 would be stored in I) 

100 X = INT(- 14.66778) (-15 would be stored in X) 
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SIN 


DEG/RAD 


SPECIAL 

PURPOSE 

FUNCTIONS 

ADR 


FRE 


PEEK 


POKE 


Format: SIN(aexp) 

Example: 100 X = SIN(Y) 

Note: Presumes Y previously defined. 

Returns the trigonometric sine of the expression in parentheses. 


Format: DEG 

RAD 

Example: 100 DEG 

100 RAD 

These two Statements allow the programmer to specify degrees or radians for 
trigonometric function computations. The Computer defaults to radians unless 
DEG is specified. Once the DEG Statement has been executed, RAD must be used 
to return to radians. 

See Appendix E for the additional trigonometric functions that can be derived. 


Format: ADR(svar) 

Example: ADR(A$) 

Returns the decimal memory address of the string specified by the expression in 
parentheses. Knowing the address enables the programmer to pass the Informa¬ 
tion to USR routines, etc. (See USR and Appendix D) 

Format: FRE(aexp) 

Examples: PRINT FRE (0) 

100 IF FRE (0X1000 THEN PRINT “MEMORY CRITICAL” 

This function returns the number of bytes of user RAM left. Its primary use is in 
Direct mode with a dummy variable (0) to inform the programmer how much 
memory space remains for completion of a program. Of course FRE can also be 
used within a BASIC program in Deferred mode. 

Format: PEEK(aexp) 

Examples: 1000 IF PEEK (4000) = 255 THEN PRINT “255” 

100 PRINT “LEFT MARGIN IS”; PEEK (82) 

Returns the contents of a specified memory address location (aexp). The address 
specified must be an integer or an arithmetic expression that evaluates to an in¬ 
teger between 0 and 65535 and represents the memory address in decimal nota- 
tion (not hexadecimal). The number returned will also be a decimal integer with 
a ränge from 0 to 255. This function allows the user to examine either RAM or 
ROM locations. In the first example above, the PEEK is used to determine 
whether location 4000 (decimal) contains the number 255. In the second exam¬ 
ple, the PEEK function is used to examine the left margin. 

Format: POKE aexpl, aexp2 

Examples: POKE 82, 10 

100 POKE 82, 20 
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ASC 


CHR$ 


STRINGS 


This section describes strings and the functions associated with string handling. 
Each string must be dimensioned (see DIM Statement, Section 8) and each string 
variable must end with a $. A string itself is a group of characters “strung” 
together. The individual characters may be letters, numbers, or symbols 
(including the Atari special keyboard symbols.) A substring is a part of a longer 
string and any substring is accessible in Atari BASIC if the string has been pro- 
perly dimensioned (see end of section). The characters in a string are indexed 
from 1 to the current string length, which is less than or equal to the dimen¬ 
sioned length of the string. 

The string functions described in this section are: 

ASC STR$ 

CHR$ VAL 

LEN 


Format: ASC(sexp) 

Examples: 100A = ASC(A$) 

This function returns the ATASCII code number for the first character of the 
string expression (sexp). This function can be used in either Direct or Deferred 
mode. Figure 7-1 is a short program illustrating the ASC function. 


10 DIM H$( 3 
20 A$="E" 

38 A=hSC< h$ > 
40 PRINT A 


Figure 7-1. ASC Function Program 


When executed, this program prints a 69 which is the ATASCII Code for the let- 
ter “E”. Note that when the string itself is used, it must be enclosed in quotation 
marks. 


Format: CHR$ (aexp) 

Examples: 100 PRINT CHR$ (65) 

100 A$ = CHR$ (65) 

This character string function returns the character, in string format, 
represented by the ATASCII code number(s) in parentheses. Only one character 
is returned. In the above examples, the letter A is returned. Using the ASC and 
CHR$ functions, the following program prints the upper case and lower case let¬ 
ters of the alphabet. 
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Upon execution, the screen displays THE SQUARE ROOT OF B$ IS 100. 


It is not possible to use the VAL function with a string that does not Start with a 
number, or that cannot be interpreted by the Computer as a number. It can, 
however, intrepret floating point numbers; e.g.,VAL(“lE9”)would return the 
number 1,000,000,000. 


STRING Strings can be manipulated in a variety of ways. They can be split, concatenated, 

MANIPULATIONS rearran g e d, and sorted. The following paragraphs describe the different 

manipulations. 

String Concatenation 

Concatenation means putting two or more strings together to form one large 
string, Each string to be included in a larger string is called a substring. Each 
substring must be dimensioned (see DIM). In Atari BASIC, a substring can con- 
tain up to 99 characters (including spaces). After concatenation, the substrings 
can be stored in another string variable, printed, or used in later sections of the 
program. Figure 7-5 is a sample program demonstrating string concatenation. 
In this program, A$, B$, and C$ are concatenated and placed in A$. 


10 di n ai< 1 0ö >, ß$( i öS > , cp: i 00 > 

20 A*="STRINGS & SUBSTRINGS ARE DISCUSSE 
D " 

30 B$="IN 'ATARI BASIC—-A SELF-TEACHING 
GUIDE'" 

40 C*="—CHARTER 9." 

5ü AK LEN; AI )+1 i-BI 
68 AK LbNi RI .1+1 )=C$ 

70 PRINT AI 


Figure 7-5. String Concatenation Example 


String Splitting 

The format of a subscript string variable is as follows: 

svarname(aexpl[ ,aexp2]) 

The svarname is used to indicate the unsubscripted string variable name (with 
$). aexpl indicates the starting location of the substring and aexp2 (if used) in- 
dicates the ending location of the substring. If no aexp2 is specifiecL then the end 
of the substring is the current end of the string. The starting location cannot be 
greater than the current length of the string. The two example programs in 
Figure 7-6 illustrate a split string with no end location indicated and a split 
string with an ending location indicated. 


18 Din SK 5) 

28 S!="ABCDr 
38 PRINT SK 2) 
40 END 

Result is BCD. 


10 DIN SK 20) 

20 S$="ATARI 808 BASIC 
30 PRINT SK 7,9) 

48 END 

Result is 800. 

(wi t h ending tucaliuu) 


Figure 7-6. Split String Examples 
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ARRAYS AND 
MATRICES 


An array is a one-dimensional list of numbers assigned to subscripted variables; 
e.g., A(0), A(l), A{2). Subscripts ränge from 0 to the dimensioned value. Figure 
8-1 illustrates a 7-element array. 


A(0) 

A(l) 

A(2) 

A(3) 

A(4) 

A(5) 

A(6) 


Figure 8-1. Example of an Array 

A matrix, in this context, is a two-dimensional table containing rows and col- 
umns. Rows run horizontally and columns run vertically. Matrix elements are 
stored by BASIC in row-major order. This means that all the elements of the 
first row are stored first, followed by all the elements of the second row, etc. 
Figure 8-2 illustrates a 7x4 matrix. 


Columns 


M(0,0) 

M(0,1) 

M(0,2) 

M(0,3) 

M(1,0) 

M(l,l) 

M(l,2) 

Md,3) 

M(2,0) 

M(2,l) 

M(2,2) 

M(2,3) 

M(3,0) 

M(3,l) 

M(3,2) 

M(3,3) 

M(4,0) 

M(4,l) 

M(4,2) 

M(4,3) 

M(5,0) 

M(5,l) 

M(5,2) 

M(5,3) 

M(6,0) 

M(6,l) 

M(6,2) 

M(6,3) 


DIM (DI.) 


Figure 8-2. Example of a Matrix 


This section describes the two commands associated with arrays, matrices, and 
strings, and how to load both arrays and matrices. The commands in this sec¬ 
tion are: 


DIM 

CLR 


Format: 


DIM 


svar(aexp) 1 

( ,svar(aexp) 1 

mvar(aexp[ ,aexp]) J 

\ ,mvar(aexp[,aexp ... ] | 


Examples: DIM A(100) 

DIM M(6,3) 

DIM B$(20) used with STRINGS 
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Figure 8-5 shows an example of building a 6x3 matrix. 


10 Din ri(b,3> 

20 FGR R0N=ö TO 6 
30 FÜR C0L=1 TO 3 

40 Mv Run lul ;>=ihT'; rnck ü ..u. i 000 

50 HEXT COL : HEXT ROH 
bö FÜR RuN=8 TO 6 
70 FOR C0L=1 TO 3 
80 PRINT N(RON;COL) 

90 HEXT COL:PRINT :HEXT RON 

Figure 8-5. Building A Matrix 

Note that the words ROW and COLUMN are not BASIC commands, Statements, 
functions, or keywords. They are simply variable names used here to designate 
which loop function is first. The program could just as easily have been written 
with X and Y as the variable names. 

Format: CLR 

Example: 200 CLR 

This command clears the memory of all previously dimensioned strings, arrays, 
and matrices so the memory and variable names can be used for other purposes. 
It also clears the values stored in undimensioned variables. If a matrix, string, or 
array is needed after a CLR command, it must be redimensioned with a DIM 
command. 
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GRAPHICS MODES 
AND COMMANDS 


This section describes the Atari BASIC commands and the different graphics 
modes of the ATARI Personal Computer. Using these commands, it is possible to 
create graphics for game, graphics, and patterns. 

The commands to be described in this section are: 

GRAPHICS LOCATE PUT/GET 

COLOR PLOT SETCOLOR 

DRAWTO POSITION XIO 

The PUT/GET and XIO commands explained in this section are special applica- 
tions of the same commands described in Section 5. 

GRAPHICS (GR.) Format: GRAPHICS aexp 

Example: GRAPHICS 2 


This command is used to select one of the nine graphics modes. Table 9-1 sum- 
marizes the nine modes and the characteristics of each. The GRAPHICS com¬ 
mand automatically opens the screen, S:(the graphics window),as device #6. So 
when printing text in the text window, it is not necessary to specify the device 
code. The aexp must be positive, rounded to the nearest integer. Graphics mode 
0 is a full-screen display while modes 1 through 8 are split screen displays. To 
Override the split-screen, add the characters +16 to the mode number (aexp) in 
the GRAPHICS command. Adding 32 prevents the graphics command from 
Clearing the screen. 


To return to graphics mode 0 in Direct mode, press 
and press J-gEEJH 


SYSTEM RESET 


or type GR.O 


TABLE 9.1—TABLE OF MODES AND SCREEN FORMATS 


SCREEN FORMAT 





Vert. 

Vert. 

Number 


Gr. 

Mode 

Horiz. 

(Col) 

(Col) 

Of 

RAM 

Mode 

Type 

CRows) 

Split 

Full 

Colors 

Required 




Screen 

Screen 


(Bytes) 

0 

TEXT 

40 

- 

24 

2 

993 

1 

TEXT 

20 

20 

24 

5 

513 

2 

TEXT 

20 

10 

12 

5 

261 

3 

GRAPHICS 

40 

20 

24 

4 

273 

4 

GRAPHICS 

80 

40 

48 

2 

537 

5 

GRAPHICS 

80 

40 

48 

4 

1017 

6 

GRAPHICS 

160 

80 

96 

2 

2025 

7 

GRAPHICS 

160 

80 

96 

4 

3945 

8 

GRAPHICS 

320 

160 

192 

1/2 

7900 


The following paragraphs describe the nine graphics modes. 
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Unless otherwise specified, all characters are displayed in upper case non¬ 
inverse form. To print lower case letters and graphics characters, use a POKE 
756,226. To return to upper case, use POKE 756,224. 

In graphics modes 1 and 2, there is no inverse video, but it is possible to get all 
the rest of the characters in four different colors (see end of section). 


(X = 0) 
(Y = 0) 



Figure 9-1. Split-Screen Display For Graphics Modes 1 and 2 


The X and Y Coordinates Start at 0 (upper left of screen). The maximum values 
are the numbers of rows and columns minus 1 (see Table 9-1). 

This split-screen configuration can be changed to a full screen display by adding 
the characters +16 to the mode number. 

Example: GRAPHICS 1 + 16 


GRAPHICS 
MODES 
3, 5, AND 7 


These three 4-color graphics modes are also split-screen displays in their default 
state, but may be changed to full screen by adding +16 to the mode number. 
Modes 3, 5, and 7 are alike except that modes 5 and 7 use more points (pixels) in 
plotting, drawing, and positioning the Cursor; the points are smaller, thereby 
giving a much higher resolution. 


GRAPHICS 
MODES 
4 AND 6 


GRAPHICS 
MODE 8 


These two 2-color graphics modes are split-screen displays and can display in 
only two colors while the other modes can display 4 and 5 colors. The advantage 
of a two-color mode is that it requires less RAM space (see Table 9-1). Therefore, 
it is used when only two colors are needed and RAM is getting crowded. These 
two modes also have a higher resolution which means smaller points than 
Graphics mode 3. 

This graphics mode gives the highest resolution of all the other modes. As it 
takes a lot of RAM to obtain this kind of resolution, it can only accomodate a 
maximum of one color and two different luminances. 
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PLOT (PL.) 


POSITION (POS.) 


PUT/GET 
(PU./GE.) 


Doing a PRINT after a LOCATE or GET from the screen may cause the data in 
the pixel which was examined to be modified. This problem is avoided by 
repositioning the Cursor and putting the data that was read, back into the pixel 
betöre doing the PRINT. The following program illustrates the use of the 
LOCATE command. 


18 GRAPHICS 3+IS 
28 COLÜR 1 
3ü SETGQLOR 2.18,8 
48 PLOT 10,15 
58 DRAHT 0 15,15 
68 LOCATE 12,15,X 
70 PRINT X 


Figure 9-2. Example Program Using LOCATE 

On execution, the program prints the data (1) determined by the COLOR State¬ 
ment which was stored in pixel 12, 15. 

Format: PLOT aexpl, aexp2 

Example: 100 PLOT 5,5 

The PLOT command is used in graphics modes 3 through 8 to display a point in 
the graphics window. The aexpl specifies the X-coordinate and the aexp2 the 
Y-coordinate. The color of the plotted point is determined by the hue and 
luminance in the color register from the last COLOR Statement executed. To 
change this color register, and the color of the plotted point, use SET- 
COLOR. Points that can be plotted on the screen are dependent on the graphics 
mode being used. The ränge of points begins at 1 and extends to one less than 
the total number of rows (X-coordinate) or columns (Y-coordinate) shown in 
Table 9-1. 

Format: POSITION aexpl, aexp2 

Example: 100 POSITION 8, 12 

The POSITION Statement is used to place the invisible graphics window Cursor 
at a speciüed location on the screen (usually precedes a PRINT Statement). This 
Statement can be used in all modes. Note that the Cursor does not actually move 
until an I/O command which involves the screen is issued. 

Formats: PUT #aexp, aexp 

GET tfaexp, avar 

Example s: 100 PUT #&, ASC(“A”) 

200 GET #1, X 

In graphics work, PUT is used to output data to the screen display. This State¬ 
ment works hand-in-hand with the POSITION Statement. After a PUT (or GET), 
the Cursor is moved to the next location on the screen. Doing a PUT to device #6 
causes the one-byte input (second aexp) to be displayed at the Cursor position. 
The byte is either an AT ASCII code byte for a particular character (modes 0-2) or 
the color data (modes 3-8). 

GET is used to input the code byte of the character displayed at the Cursor posi¬ 
tion, into the specified arithmetic variable. The values used in PUT and GET cor- 
respond to the values in the COLOR Statement. (PRINT and INPUT may also be 
used.) 
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TABLE 9.4—TABLE OF SETCOLOR “DEFAULT” COLORS* 

Setcolor 
(Color Register) 

Defaults To 
Color 

Luminance 

Actual Color 

0 

2 

8 

ORANGE 

1 

12 

10 

GREEN 

2 

9 

4 

DARK BLUE 

3 

4 

6 

PINK OR RED 

• 4 

0 

0 

BLACK 

* “DEFAULT” occurs 

if not SETCOLOR Statement is used. 


Note: Colors may vary depending upon the television monitor type, condition, 
and adjustment. 


A program illustrating Graphics mode 3 and the commands explained so far in 
this section is shown below: 


18 

GRAPHICS 

—i 

j 



28 

SETC 

3L0K 

0,.2..8 : C 

JLuE 

1 

30 

PLOT 

17; 1 

: ORANT0 

J "1 

i { .« 

18 : DRANTO 9;18 

40 

PLOT 

19.. 1 

: DRhNTO 

19, 

i q 

5£i 

PLOT 

20.. 1 

. nrvv IT.-: 

• ÜP.HW i U 

28,. 

18 

68 

PLOT 

■! 

: URAN i U 

^ i 

18 ; ORANTO 30;lo 

78 

POLE 

i •-»£ .< 

1 



30 

PRINT : PR 

T IT II 
i i‘1 ! 

-r 

H i 

AK I PERsuHAL COMP 

UTERS !! 





90 

GOT u 

98 





The SETCOLOR and COLOR Statements set the color of the points to be plotted 
(see Table 9.5). The SETCOLOR command loads color register 0 with hue 2 
(orange) and a luminance of 8 (“normal”). The next 4 lines plot the points to be 
displayed. Line 90 suppresses the Cursor and line 100 prints the string expres- 
sion ATARI PERSONAL COMPUTERS in the text window (6 spaces in). 


Note that the background color was never set because the default is the desired 
color (black). 


If the program is executed, it will print the Atari logo in the graphics window 
and the string expression in the text window as in Figure 9-3. 
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TABLE 9.5—MODE, SETCOLOR, COLOR TABLE 


Default 

Colors 

Mode or 
Condition 

SETCOLOR 

(aexpl) 

Color 

Register No. 

Color 

(aexp) 

DESCRIPTION AND COMMENTS 



0 

COLOR data 

_ 

LIGHT BLUE 

MODE 0 and 

1 

actually 

Character luminance (same color as background) 

DARK BLUE 

ALL TEXT 

2 

determines 

Background 


WINDOWS 

3 

character to 

— 

BLACK 


4 

be plotted 

Border 

ORANGE 


0 

COLOR data 

Character 

LIGHT GREEN 

MODES 1 

1 

actually determines 

Character 

DARK BLUE 

and 

2 

character to be 

Character 

RED 

2 

3 

plotted 

Character 

BLACK 

(Text Modes) 

4 


Background, Border 

ORANGE 


0 

1 

Graphics point 

LIGHT GREEN 

MODES 3, 5, 

1 

2 

Graphics point 

DARK BLUE 

and 7 

2 

3 

Graphics point 


(Four-color 

3 

- 

— 

BLACK 

Modes) 

4 

0 

Graphics point (background default), Border 

ORANGE 

MODES 4 

0 

1 

Graphics point 


and 6 

1 

- 

— 


(Two-color 

2 

- 

— 


Modes) 

3 

- 

— 

BLACK 

4 

0 


Graphics point (background default), Border 

LIGHT GREEN 


0 

_ 

_ 

DARK BLUE 


1 

1 

Graphics point luminance (same color as background) 


MODE 8 

2 

0 

Graphics point (background default) 


(1 Color 

3 

- 

— 

BLACK 

2 Luminances) 

4 

- 

Border 































Table 9.6—INTERNAL CHARACTER SET 



S 

Oh 



CO 

H-H 

3 

> 

£ 

X 

>•> 

N 







w 













© 

© 

© 

c 

s 

4t 

CM 

vH 

vH 

CO 

vH 

vH 

vH 

vH 


CD 

vH 

vH 

IN 

vH 

vH 

CO 

vH 

vH 

cn 

vH 

vH 

o 

CM 

tH 

vH 

cM 

vH 
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In mode 0 these characters must be preceded with an escape, CHR$(27), to be printed. 
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SOUND (SO.) 


SOUNDS AND GAME 
CONTROLLERS 


This section describes the Statement used to generate musical notes and sounds 
through the audio System of the television monitor. Up to four different sounds 
can be “played” simultaneously creating harmony. This SOUND Statement can 
also be used to simulate explosions, whistles, and other interesting sound ef- 
fects. The other commands described in this section deal with the functions 
used to manipulate the keyboard, joystick, and paddle Controllers. These func¬ 
tions allow these Controllers to be plugged in and used in BASIC programs for 
games, etc. 

The command and functions covered in this section are: 

SOUND PADDLE STICK 

PTRIG STRIG 


Format: SOUND aexpl, aexp2, aexp3, aexp4 

Example: 100 SOUND 2, 204, 10, 12 

The SOUND Statement causes the specified note to begin playing as soon as the 
Statement is executed. The note will continue playing until the program en- 
counters another SOUND Statement with the same aexpl or an END Statement. 
This command can be used in eit her Direct or Deferred modes. 


The SOUND parameters are described as follows: 

aexpl = Voice. Can be 0-3, but each voice requires a separate SOUND State¬ 
ment. 

aexp2 = Pitch. Can be any number between 0-255. The larger the number, 
the lower the pitch. Table 10-1 defines the pitch numbers for the 
various musical notes ranging from two octaves above middle C to 
one octave below middle C. 

aexp3 = Distortion. Can be even numbers between 0-14. Used in creating 
sound effects. A 10 is used to created a “pure” tone whereas a 12 
gives an interesting buzzer sound. A buzzing sound (like engines at 
a race track) can be produced using two separate SOUND commands 
with the distortion value (aexp3) alternating between 0 and 1. A 
value of 1 is used to force output to the Speaker using the specified 
volume (see aexp4). The rest of the numbers are used for other 
special effects, noise generation, and experimental use. 

aexp4 = Volume control. Can be between 1 and 15. Using a 1 creates a sound 
barely audible whereas a 15 is loud. A value of 8 is considered nor¬ 
mal. If more than 1 sound Statement is being used, the total volume 
should not exceed 32. This will create an unpleasant “clipped” tone. 
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GAME 

CONTROLLER 

FUNCTIONS 


Figure 10-2 is an illustration of the three Controllers used with the Atari Per¬ 
sonal Computers. The Controllers can be attached directly to the Atari Per¬ 
sonal Computer or to external mechanical devices so that outside events can be 
fed directly to the Computer for processing and control purposes. 



Figure 10-2. Game Controllers 


PADDLE Format: PADDLE(aexp) 

Example: PRINT PADDLE® 

This function returns the Status of a particular numbered Controller. The paddle 
Controllers are numbered 0-7 from left to right. This function can be used with 
other functions or commands to “cause” further actions like sound, graphics 
Controls, etc. For example, the Statement IF PADDLE(3) = 14 THEN PRINT 
“PADDLE ACTIVE.” Note that the PADDLE function returns a number bet- 
ween 1 and 228, with the number increasing in size as the knob on the Con¬ 
troller is rotated counterclockwise (turned to the left). 


PTRIG Format: PTRIG(aexp) 

Example: 100 IF PTRIG® = 0 THEN PRINT “MISSILES FIRED!” 

The PTRIG function returns a Status of 0 if the trigger button of the designated 
Controller is pressed. Otherwise, it returns a value of 1. The aexp must be a 
number between 0 and 7 as it designates the Controller. 


STICK 


Format: STICK(aexp) 

Example: 100 PRINT STICK® 


This function works exactly the same way as the PADDLE command, but can be 
0-3 from left to right. 


Controller 1 = STICK® 
Controller 2 = STICK® 
Controller 3 = STICK® 
Controller 4 = STICK® 


Figure 10-3 shows the numbers that will be returned when the joystick Con¬ 
troller is moved in any direction. 
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ADVANCED PROGRAMMING 

TECHNIQjUES 


This section includes hints on increasing programming efficiency, conserving 
memory, and combining machine language programs with Atari BASIC pro- 
grams. This section does not include an instruction set for the 6502 micro- 
processor chip nor does it give instructions on programming in machine 
language. An additional purchase of the Atari Assembler Editor cartridge* and 
a careful study of Atari’s Assembler Editor Manual are strongly recommended. 


MEMORY 

CONSERVATION These hints give ways of conserving memory. Some of these methods make pro¬ 
grams less readable and harder to modify, but there are cases where this is 
necessary due to memory limitations. 


1. In many small Computers, eliminating blank spaces between words and 
characters as they are typed into the keyboard will save memory. This is not 
true of the ATARI Personal Computer System, which removes extra spaces. 
Statements are always displayed the same regardless of how many spaces 
were used on program entry. Spaces should be used (just as in typing on a 
conventional typewriter) between successive keywords and between 
keywords and variable names. Here is an example: 


10 IF A = 5 THEN PRINT A 


Note the space between IF and A and between THEN and PRINT. In most 
cases, a Statement will be interpreted correctly by the Computer even if all 
spaces are left out, but this is not always true. Use conventional spacing. 


2. Each new line number represents the beginning of what is called a new 
“logical line”. Each logical line takes 6 bytes of “overhead”, whether it is 
used to full capacity or not. Adding an additional BASIC Statement by using a 
colon (:) to separate each pair of Statements on the same line takes only 3 
bytes. 


*Available late 1980. 
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7. Each character after REM takes one byte of memory. Remarks are helpful to 
people trying to understand a program, but sometimes it is necessary to 
remove remark Statements to save memory. 


8. Subroutines can save memory because one subroutine and several short calls 
take less memory than duplicating the code several times. On the other 
hand, a subroutine that is only called once takes extra bytes for the GOSUB 
and RETURN Statements. 


9. Parentheses take one byte each. Extra parentheses are a good idea in some 
cases if they make an expression more understandable to the programmer. 
However, removing unnecessary parentheses and relying on operator 
precedence will same a few bytes. 


PROGRAMMING 
IN MACHINE 
LANGUAGE 


Machine language is written entirely in binary code. The ATARI Personal Com¬ 
puter contains a 6502 microprocessor and it is possible to call 6502 machine code 
subroutines from BASIC using the USR function. Short routines may then be 
entered into a program by hand assembly (if necessary). 


Before it returns to BASIC, the assembly language routine must do a pull ac- 
cumulator (PLA) instruction to remove the number (N) of input arguments off 
the stack. If this number is not 0, then all of the input arguments must be pop- 
ped off the stack also using PLA. (See Figure 6-1). 


The subroutine should end by placing the low byte of its result in location 212 
(decimal), and then return to BASIC using an RTS (Return from Subroutine) in¬ 
struction. The BASIC interpreter will convert the 2-byte binary number stored 
in locations 212 and 213 into an integer between 0 and 65535 in floating-point 
format to obtain the value returned by the USR function. 


The ADR function may be used to pass data that is stored in arrays or strings to a 
subroutine in machine language. Use the ADR function to get the address of the 
array or string, and then use this address as one of the USR input arguments. 


The following program, Hexcode Loader, provides the means of entering hexa- 
decimal codes, converting each hexadecimal number to decimal, and storing the 
decimal number into an array. The array is then executed as an assembly 
language subroutine. (An array is used to allocate space in memory for the 
routine.) 
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2. Now add the BASIC language part of your program starting at line 1080 in- 
cluding the USR function that calls the machine language subroutine. (See 
example below.) 

3. Count the total number of hex codes to be entered and enter this number on 
line 1000 when requested. If another number is already entered, simply 
replace it. 

4. Run the program and enter the hexadecimal codes of the machine level 
subroutine pressing EäSEEI after each entry. After the last entry, type 
DONE and press lilaffliUI . 

5. Now the DATA line (1500) displays on the screen. It will not be entered into 

the program until the Cursor is moved to the DATA line and is 

pressed. 

6. Add a program line 5 GOTO 1000 to bypass the hexcode loader (or delete the 
hexcode loader through line 260). Now save the completed program by 
using CSAVE or SAVE. It is important to do this before executing the part of 
the program containing the USR call. A mistake in a machine language 
routine may cause the System to crash. If the System does hang up, press 
EEESES51 • If the System doesn’t respond, turn power off and on again, 
reload the program, and correct it. 


Note: This method only works with relocatable machine language routines. 


The following two sample programs can each be entered into the Hexcode 
Loader program. The first program prints NOTHING IS MOVING while the 
machine program changes the colors. The second sample program displays a 
BASIC graphics design, then changes colors. 


1088 GRAPHICS 1+16 
1098 FÜR 1=1 T0 6 

1108 F’RIHT #6; "nüthire is fiiouins!" 
1118 PRINT #6;"NOTHING IS HOUING!" 
1120 FR INT #6.; "nothins is movirs!" 
1130 PRINT #6; "NOTHING IS riQUING!" 
1148 NEXT I 
1150 Q=USR< A0R< E$)+1> 

1168 FOR 1=1 TO 25=NEXT I=GOTO 1158 


After entering this program, check that line 1000 reads: 

1000 CLR:BYTES = 21 


Type RUN »;bIH.1!» . 
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When completed, type DONE and press filällL 
last entry (999) on the DATA line and press | 


|. Now place the Cursor after the 


Now run the program by typing GOTO 1000 and pressing or add line 5 

GOTO 1000 and type RUN ÖBU- Press BHüTTM to stop program and delete line 
5. 


Figure 11-2 illustrates an assembler subroutine used to rotate colors which 
might prove useful. It is included here for the information of the user. 


Assembler Subroutine to Rotate Colors.. 


Address 

Object 

Line 

Label 

Mnemonic Data 



Code 

No. 







0100 




Routine to rotate COLOR data 



0110 




From one register to another. 



0120 




4 colors are rotated. 



0130 







0140 




Operating System address 

02C4 


0150 




COLOR 0 = $02C4 

02C5 


0160 




COLOR 1 = $02C5 

02C6 


0170 




COLOR 2 = $02C6 

02C7 


0175 




COLOR 3 = $02C7 



0180 







0190 


* = 

$6000 

Machine program starting address* 

6000 

68 

0200 


PLA 


Pop stack (See Chapter 4) 

6001 

A200 

0210 


LDX 

»0 

Zero the X register 

6003 

ACC402 

0220 


LDY 

COLORO 

Save COLOR 0 

6006 

BDC502 

0230 

LOOP 

LDA 

COLORl,X 


6009 

9DC402 

0240 


STA 

COLORO,X 


600C 

E8 

0250 


INX 


Increment the X register (add one) 

600D 

E002 

0260 


CPX 

»3 

Compare contents of X register 
with 2 

600F 

90F5 

0270 


BCC 

LOOP 

Loop if X register contents are 
less than 2 

6011 

8CC602 

0280 


STY 

COLOR3 

Save COLOR 0 in COLOR 3 

6014 

60 

0290 


RTS 


Return from machine level sub¬ 
routine 

Assembler 


This Portion is 

Source Information Programmer Enters 

Prints This 



Using Atari Assembler Cartridge 


# Indicates data (source) 

* Routine is relocatable 

$ Indicates a hexadecimal number 


Figure 11-2. Assembler Subroutine To Rotate Colors 
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APPENDIX A 


ALPHABETICAL DIRECTORY 
OF BASIC RESERVED WORDS 


Note: The period is mandatory after all abbreviated keywords. 


RESERVED 

WORD: 

ABBRE VIATION: 

BRIEF SUMMARY 

OF BASIC STATEMENT 

ABS 


Function returns absolute value (unsigned) of the 
variable or expression. 

ADR 


Function returns memory address of a string. 

AND 


Logical operator: Expression is true only if both subex- 
pressions joined by AND are true. 

ASC 


String function returns the numeric value of a single 
string character. 

ATN 


Function returns the arctangent of a number or expres¬ 
sion in radians or degrees. 

BYE 

B. 

Exit from BASIC and return to the resident operating 
System or console processor. 

CLOAD 

CLOA. 

Loads data from Program Recorder into RAM. 

CHR$ 


String function returns a single string byte equivalent 
to a numeric value between 0 and 255 in AT ASCII code. 

CLOG 


Function returns the base 10 logarithm of an expres¬ 
sion. 

CLOSE 

CL. 

I/O Statement used to close a file at the conclusion of I/O 
operations. 

CLR 


The opposite of DIM: Undimensions all strings; 
matrices. 

COLOR 

C. 

Chooses color register to be used in color graphics 
work. 

COM 


Same as DIM. 

CONT 

CON. 

Continue. Causes a program to restart execution on the 
next line following use of the üETOM key or encounter- 
ing a STOP. 

COS 


Function returns the cosine of the variable or expres¬ 
sion (degrees or radians). 

CSAVE 


Outputs data from RAM to the Program Recorder for 
tape storage. 
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RESERVED 

WORD: 


ABBRE VIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


LET 

LE. 

Assigns a value to a specific variable name. LET is op¬ 
tional in Atari BASIC, and may be simply omitted. 

LIST 

L. 

Display or otherwise output the program list. 

LOAD 

LO. 

Input from disk, etc. into the Computer. 

LOCATE 

LOC. 

Graphics: Stores, in a specified variable, the value that 
Controls a specified graphics point. 

LOG 


Function returns the natural logarithm of a number. 

LPRINT 

LP. 

Command to line printer to print the specified message. 

NEW 


Erases all contents of user RAM. 

NEXT 

N. 

Causes a FOR/NEXT loop to terminate or continue 
depending on the particular variables or expressions. 
All loops are executed at least once. 

NOT 


A “1” is returned only if the expression is NOT true. If 
it is true, a “0” is returned. 

NOTE 

NO. 

See DOS/FMS Manual ...used only in disk operations. 

ON 


Used with GOTO or GOSÜB for branching purposes. 
Multiple branches to different line numbers are possible 
depending on the value of the ON variable or expres¬ 
sion. 

OPEN 

O. 

Opens the specified file for input of output operations. 

OR 


Logical operator used between two expressions. If 
either one is true, a “1” is evaluated. A “0” results only 
ifboth are false. 

PADDLE 


Function returns position of the paddle game Controller. 

PEEK 


Function returns decimal form of contents of specified 
memory location (RAM or ROM). 

PLOT 

PL. 

Causes a single point to be plotted at the X,Y location 
specified. 

POINT 

P. 

Used with disk operations only. 

POKE 

POK. 

Insert the specified byte into the specified memory loca¬ 
tion. May be used only with RAM. Don’t try to POKE 
ROM or you’ll get an error. 

POP 


Removes the loop variable from the GOSUB stack. Used 
when departure from the loop is made in other than 
normal manner. 

POSITION 

POS. 

Sets the Cursor to the specified screen position. 

PRINT 

PR. or ? 

I/O command causes output from the Computer to the 
specified output device. 
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RESERVED 

WORD: 


ABBREVIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


STR$ 


Function returns a character string equal to numeric 
value given. For example: STR$(65) returns 65 as a 
string. 

THEN 


Used with IF: If expression is true, the THEN 
Statements are executed. If the expression is false, con- 
trol passes to next line. 

TO 


Used with FOR as in “FOR X = 1 TO 10”. Separates the 
loop ränge expressions. 

TRAP 

T. 

Takes control of program in case of an INPUT error 
and directs execution to a specified line number. 

USR 


Function returns results of a machine-language 
subroutine. 

VAL 


Function returns the equivalent numeric value of a 
string. 

XIO 

X. 

General I/O Statement used with disk operations (see 
DOS/FMS Manual ) and in graphics work (Fill). 
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APPENDIX B 


ERROR 
CODE NO. 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 


ERROR 

MESSAGES 


ERROR CODE MESSAGE 

Memory insufflcient to störe the Statement or the new variable name or to DIM a 
new string variable. 

Value Error: A value expected to be a positive integer is negative, a value ex- 
pected to be within a specific ränge is not. 

Too Many Variables: A maximum of 128 different variable names is allowed. 

(See Variable Name Limit.) 

String Length Error: Attempted to störe beyond the DIMensioned string length. 

Out of Data Error: READ Statement requires more data items than supplied by 
DATA statement(s). 

Number greater than 32767: Value is not a positive integer or is greater than 
32767. 

Input Statement Error: Attempted to INPUT a non-numeric value into a 
numeric variable. 

Array or String DIM Error: DIM size is greater than 32767 or an array/martix 
reference is out of the ränge of the dimensioned size, or the array/matrix or string 
has been already DIMensioned, or a reference has been made to an undimensioned 
array or string. 

Argument Stack Overflow: There are too many GOSUBs or too large an expres- 
sion. 

Floating Point Overflow/Underflow Error: Attempted to divide by zero or 
refer to a number larger than 1 x 10 98 or smaller than 1x10- ". 

Line Not Found: A GOSUB, GOTO, or THEN referenced a non-existent line 
number. 

No Matching FOR Statement: A NEXT was encountered without a previous 
FOR, or nested FOR/NEXT Statements do not match properly. (Error is reported at 
the NEXT Statement, not at FOR). 

Line Too Long Error: The Statement is too complex or too long for BASIC to 
handle. 

GOSUB or FOR Line Deleted: A NEXT or RETURN Statement was encountered 
and the corresponding FOR or GOSUB has been deleted since the last RUN. 
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ERROR 

CODE NO. ERROR CODE MESSAGE 


143 Serial bus data frame checksum error. 

144 Device done error (invalid “done” byte): Attempt to write on a write-protected 
diskette. 

145 Read after write compare error (disk handler) or bad screen mode handler. 

146 Function not implemented in handler. 

147 Insufficient RAM for operating selected graphics mode. 

160 Drive number error. 

161 Too many OPEN flies (no sector buffer available). 

162 Disk full (no free sectors). 

163 Unrecoverable System data I/O error. 

164 File number mismatch: Links on disk are messed up. 

165 File name error. 

166 POINT data length error. 

167 File locked. 

168 Command invalid (special Operation code). 

169 Directory full (64 flies). 

170 File not found. 

171 POINT invalid. 
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APPENDIX C 


AT ASCII 
CHARACTER SET 


v> 


A> 
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APPENDIX D 


ATARI 400/800 
MEMORY MAP 


ADDRESS 


CONTENTS 


Decimal 

Hexadecimal 



65535 

57344 

FFFF 

E000 

OPERATING SYSTEM ROM 


57343 

55296 

DFFF 

D800 

FLOATING POINT ROM 


55295 

53248 

D7FF 

D000 

HARDWARE REGISTERS 


53247 

49152 

CFFF 

cooo 

NOT USED 


49151 

BFFF 

CARTRIDGE SLOT A 


40960 

A000 

(may be RAM if no A or B cartridge) 



40959 

32768 


9FFF 

8000 


CARTRIDGE SLOT B 

(may be RAM if no B cartridge) 


RAMTOP (MSB) 


32767 


7FFF 


(7FFF if 32K System) 
DISPLAY DATA (size varies) 


31755 


7CIF 


DISPLAY LIST (size varies) 

(7C1F if 32K System, (GRAPHICS 0) 


OS MEMTOP 


FREE RAM 
(size varies) 


BASIC MEMTOP 


10880 


2A80 


BASIC program, buffers, tables, run-time stack. 
(2A80 if DÖS, may vary) 




OS MEMLO 


_ BASIC LOMEM 


10879 

2A7F 

DISK OPERATING SYSTEM (2A7F-700) 

9856 

2680 

DISK I/O BUFFERS (current DOS) 

9855 

4864 

267F 

1300 

DISK OPERATING SYSTEM RAM (current DOS) 
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APPENDIX E 


DERIVED 

FUNCTIONS 


Derived Functions 


Derived Functions in Terms of Atari Functions 


Secant 
Cosecant 
Inverse Sine 
Inverse Cosine 
Inverse Secant 
Inverse Cosecant 
Inverse Cotangent 
Hyperbolic Sine 
Hyperbolic Cosine 
Hyperbolic Tangent 
Hyperbolic Secant 
Hyperbolic Cosecant 
Hyperbolic Cotangent 
Inverse Hyperbolic Sine 
Inverse Hyperbolic Cosine 
Inverse Hyperbolic Tangent 
Inverse Hyperbolic Secant 
Inverse Hyperbolic Cosecant 
Inverse Hyperbolic Cotangent 


SEC(X) = l/COS(X) 

CSC(X) = 1/SIN(X) 

ARCSIN(X) = ATN(X/SQR(-X*X +1)) 

ARCCOS® = - ATN(X/SQR( - X*X +1) + CONSTANT 

ARSEC® = ATN(SQR® X-l)) + (SGN®1)* CONSTANT 

ARCCSC(X) = ATNÜ/SQR® X-l)) + (SGN® 1)* CONSTANT 

ARCCOT® = ATN® + CONSTANT 

SINH(X) = (EXP(X)-EXP(-X))/2 

COSH® = (EXP(X) + EXP(-X))/2 

TANH(X) = -EXP(-X)/(EXP(X) + EXP(®)*2 +1 

SECH(X) = 2/(EXP(X) + EXP(-X)) 

CSCH(X) = 2/(EXP(X)-EXP(®) 

COTH® = EXP(-X)/(EXP(X)-EXP(-X)) * 2 +1 
ARCSINH® = LOG(X + SQR(X * X +1)) 

ARCCOSH® + LOG(X + SQR(X*X-1)) 

ARCTANH® = LOG((l + X)/(l-X))/2 
ARCSECH® = LOG((SQR(-X*X +1) + 1)® 

ARCCSCH® = LOG((SGN® *SQR(X*X+1) + 1)/X) 
ARCCOTH® = LOG((X + l)/(X-l))/2 


Notes: 

1. If in RAD (default) mode, constant = 1.57079633 
If in DEG mode, constant = 90. 

2. In this chart, the variable X in parentheses represents the value or expression to be evaluate d by the 
derived function. Obviously, any variable name is permissible, as long as it represents the number or 
expression to be evaluated. 
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APPENDIX F 


PRINTED VERSIONS 
OF CONTROL CHARACTERS 


The Cursor and screen control characters can be placed in a string in a program or used as a Direct mode 
Statement by pressing the (£19 key before entering the character from tbe keyboard. This causes the 
special Symbols which are shown below to be displayed. (Refer to Section 1 - |^J Key.) 
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APPENDIX G 


GLOSSARY 


Alphanumeric: 
Array: 


ATASCII: 

BASIC: 


Binary: 


Bit: 


Branch: 


Bug: 

Byte: 

Central Processing 
Unit (CPU): 


Code: 

Command: 


The alphabetic letters A-Z, the numbers 0-9, and some symbols. (No 
punctuation marks or graphics symbols). 

A list of numerical values stored in a series of memory locations 
preceded by a DIM Statement. May be referred to by use of an array 
variable, and its individual elements are referred to by subscripted 
variable names. 

Stands for Atari American Standard Code for Information Inter¬ 
change. 

High level programming language. Acronym for Beginner’s All¬ 
purpose Symbolic Intruction Code. BASIC is always written using all 
Capital letters. Developed by Mssrs. Kemeny and Kurtz at Dartmouth 
College in 1963. 

A number System using the base two. Thus the only possible digits 
are 0 and 1, which may be used in a Computer to represent true and 
false, on and off, etc. 

Short for Binary Digit. A bit can be thought of as representing true or 
false, whether a circuit is on or off, or any other type of two- 
possibility concept. A bit is the smallest unit of data with which a 
Computer can work. 

Atari BASIC executes a program in order of line numbers. This ex- 
ecution sequence can be altered by the programmer, and the pro¬ 
gram can be told to skip over a certain number of lines or return to a 
line earlier in the program. This contrived change in execution se¬ 
quence is called “branching”. 

A mistake or error usually in the program or “Software”. 

Usually eight bits (enough to represent the decimal number 255 or 
11111111 in binary notation). A byte of data can be used to represent 
an ATASCII character or a number in the ränge of 0 to 255. 

In microcomputers such as the Atari Systems, these are also called 
microprocessors or MPU. At one time, the CPU was that portion of 
any Computer that controlled the memory and peripherals. Now the 
CPU or MPU is usually found on a single integrated circuit or “chip” 
(in Atari’s case a 6502 microprocessor chip). 

Instructions written in a language understood by a Computer. 

An instruction to the Computer that is executed immediately. A good 
example is the BASIC command RUN. (See Statement.) 
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Hardware: 


Increment: 

Initialize: 

Input: 

Interactive: 

Interface: 

IOCB 

I/O: 

K: 

Key word: 

Language: 

Memory: 

Menu: 

Mierocomputer: 

Monitor: 

Null String: 

OS: 

Output: 

Parallel: 

Peripheral: 


The physical apparatus and electronics that make up a Computer. 

Increase in value (usually) by adding one. Used a lot for counting (as 
in counting the number of repetitions through a loop). 

Set to an initial or starting value. In Atari BASIC, all non-array 
variables are initialized to zero when the command RUN is given. Ar- 
ray and string elements are not initialized. 

Information transfer to the Computer. Output is information transfer 
away from the Computer. In this manual, input and output are 
always in relation to the Computer. 

A System that responds quickly to the user, usually within a second 
or two. All personal Computer Systems are interactive. 

The electronics used to allow two devices to communicate. 

Input/Output Control Block. A block of data in RAM that teils the 
Operating System the information it needs to know for an I/O Opera¬ 
tion. 

Short for input/output, I/O devices include the keyboard, TV 
monitor, program recorder, printer, and disk drives. 

Stands for “kilo” meaning “times 1000”. Thus 1 KByte is (approx- 
imately) 1000 bytes. (Actually 1024 bytes.) Also, the device type code 
for the Keyboard. 

A word that has meaning as an instruction or command in a Com¬ 
puter language, and thus must not be used as a variable name or at 
the beginning of a variable name. 

A set of conventions specifying how to teil a Computer what to do. 

The part of a Computer (usually RAM or ROM) that Stores data or in¬ 
formation. 

A list of options from which the user may choose. 

A Computer based on a microprocessor chip; in Atari’s case, the 6502. 
The television receiver used to display Computer output. 

A string consisting of no characters whatever. 

Abbreviation for Operating System. This is actually a collection of 
programs to aid the user in Controlling the Computer. Pronounced 
“oh ess”. 

See I/O. 

Two or more things happening simultaneously. A parallel interface, 
for example, Controls a number of distinct electrical Signals at the 
same time. Opposite of serial. 

An I/O device. See I/O. 
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APPENDIX H 


USER 

PROGRAMS 


This appendix contains programs and routines that demonstrate the diverse 
capabilities of the Atari Personal Computer System. Included in this appendix is 
a Decimal/Hexadecimal program for those users who write programs that re- 
quire this type of conversion. 


CHECKBOOK 

BALANCER 


This is one of the “traditional” programs that every beginning computerist 
writes. It allows entry of outstanding checks and uncredited deposits as well as 
cleared checks and credited deposits. 


10 DIU h*< 38 MSG$< 48), MSG1$( 30), MSG2K 3 
0 >, HSG3« 38 >, riSG4$< 30), MSG5$( 38), MSGSft 3 
0 ) 

20 0UTSTAND=8 

30 GRAPHICS 0 : 7 =? " CHECKBOOK BALAN 
CER":? 

48 ? “You maa make corrections at ana tl 
me ba enter ins a nesatiue doll an value. 

H 

58 nSGl$= n 0LD CHECK — STILL OUTSTANDING 

11 

60 riSG2$="0LD DEPOSIT — NOT CREDITED 
1( 

70 nSG3$="0LD CHECK — JUST CLEARED 

ll 

80 f1SG4$="0LD DEPOSIT — JUST CREDITED 

ll 

98 MSG5*="HEW CHECK (OR SERUICE CHARGE) 

ll 

108 nSG6$="NEW DEPOSIT (OR INTEREST) 

ll 

150 TRAP 158 : ? "Enter besinnIr® baiance 
froiii aour checkbock"; : INPUT YOURBAL 
160 TRAP 168 : ? "Enter besinnine baiance 
froiTi aour bankStatement"; • INPUT BANKBAL 
165 TRAP 48080 
170 GOTO 198 

180 CLOSE #1=? "PRINTER IS NOT OPERATION 
AL," 

185 ? "PLEASE CHECK CONNECTORS." 

190 PERM=8 

288 '? "Woul d aou like a permanent record 
m the Printer"; : INPUT A$ 

210 IF LENCA$ >=0 THEN 280 


Appendix H-l 



5830 ? "IS NEU CHECK 
sINPUT AI 


r-T T I ? f« ITCTAI in T i if ;i . 

O) 1LL üü i o i Hflü i nu ; 


5040 IF LEN< AI)=6 THEN 5030 
5050 IF AK1,1X>"N" THEN 5060 
5055 BANKBAL=BAHKBAL-AMOUHT 

5057 IF PERM THEN LF’RINT "CHECK HAS CLEA 
RED." 

5058 RETURN 

5868 IF H& 1,1 }<>'"/" THEN 5030 
5870 OUTSThNO=OUTSTAND+AMOUNT 
5075 IF PERM THEN LF’RIHT "CHECK IS STILL 
OUTSTANDING.“ 

5880 RETURN 


6088 REM NEU DEPOSIT <ÜR INTEREST) — JU 


ST CREDITED 


6818 MSGI=MSG6$ : GOSUB 8180 

6028 YOUREAL=YQURBAL+AMOUNT 

6838 ? "HAS YOUR NEU DEPOSIT BEEK CREDIT 

ED".; = INPUT AI 

6048 IF LEN<A$>=0 THEN 6838 
6858 IF AK 1,1X>"Y" THEN 6069 

6052 BANKBAL=BANKBAL+hMOUHT 

6053 IF PERM THEN LF’RIHT "DEPOSIT HAS BE 


EN CREDITED." 

6055 RETURN 

6868 IF Aid,!X>"N" THEN 6838 

6078 OUTSTAND=ÜUTSTAND-AMOUHT 

6875 IF PERM THEN LF’RIHT "DEPOSIT HAS HO 

T BEEN CREDITED." 

6088 RETURN 
7088 REM DOME 

7810 ? "BANK'S BALANCE MINUS (OUTSTAND IN 
G CHECKS-DEPOSITS) SHOULD NOH EQUAL 
Y0URCHECK800K BALANCE." 

7028 DIF=Y0UR8AL-(BAHKBAL-OUTSTAND) 

7038 IF DIFO0 THEN 7848 

7035 ? "IS l'UBANKBAL;" THE ENDING 8ALAN 
CE ON YOUR BANK STATEMENT".;:INPUT AI 

7036 IF LEH(AI>=0 THEN 7835 

7837 IF AK 1 , 1 )="Y" THEN ? “CONGRATULATI 
ÖNS : YOUR CHECKBOOK BALANCES!" : END 


7838 GOTO 7068 

7848 IF DIF>8 THEN ? "YOUR CHECKBOOK TOT 
AL IS l";DIF;" OUER YOUR BANK 1 S TOTAL. " 
: GOTO 7868 

7858 ? "YOUR CHECKBOOK TOTAL IS l H ;-OIF; 
" INDER YOUR BANK'S TOTAL." 

7068 ? “WOULD YOU LIKE TO MAKE CÜRRECTIO 
NS?" 

7878 ? "REMEMBER, YOU CAN ENTER A NEGATI 
UE DOLLAR UALUE TO MAKE A CÖRRECTION. 
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BUBBLE SORT 


This program uses the string comparison operator “<= ” that Orders strings ac- 
cording to the ATASCII values of the various characters. Since Atari BASIC does 
not have arrays of strings, all the strings used in this program are actually 
substrings of one large string. A bubble sort, though relatively slow if there are 
a lot of items to be stored, is easy to write, fairly short, and simpler to under- 
stand than more complex sorts. 


18 Din 8$<1> 

28 GRAPHICS 8 : ? : ? " STRING SO 

RT" 

38 TRAF' 38 = ? = ? "Enter iraximum strire le 
rsth";=INPUT SIEH=SLEN1=SLEH-1 
35 IF SLEN< 1 OR INK SIEH X>SLEN THEN ? " 
FLEASE ENTER A PDSITIUE INTEGER > 8." : GO 
TO 39 

48 TRAP 40 : Y = ? "Enter maximum number of 
entriss." 

41 7 "(Entriss which are shortsr than th 
e maximum will be eadded wit-h blanks. .i 


42 INPUT ENTRISS 

45 IF ENTRIESC2 OR INT< ENTRIES X>ENTRIES 
THEN ? "FLEASE ENTER A POSITIVE INTEGER 
> 1."-GOTO 43 
47 TRAP 48808 

58 DIN A$(SLENSENTRIES),TEMPKSLEN) 

60 ? : ? "Enter strinss one at a time." 

70 Y "Enter emrt-y strins when done (just 
hit-RETURN)." 

75 ? ■•? "PLEASE STAND BY NH ILE THE STRIN 
GS ARE BEIHG CLEARED. 

80 FOR 1=1 TO SLENXENTRIES : AK I > I )=" "-H 
EXT I 
85 ? =? 


90 1=1 

108 FOR J=1 TO ENTRIES 

110 ? "#"J;" "; ; INPUT TEMPI 

128 IF LEN( TEflPI )=0 THEN ENTRIES=J-1 : GOT 

0 190 

138 AK I.- I+SLEN1 )=TEMF’$ 

148 I=I+SLEN 
158 NEXT J 

198 ? :? ••? »FLEASE STAND BY NH ILE THE S 
TRINGS ARE BEING SORTEO. 

208 bObüB 1808 : REM CALL SOFlT ROUTINE 
282 ? ■•? 

285 1=1 

210 FOR K=1 TO ENTRIES 
228 ? " ’UAf(I,I+SLEN1 > 

225 I=I+SLEN 
238 NEXT K 

248 TRAP 388=? =? "WOULD YOU LIKE A PRIN 
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TEXT MODES 
CHARACTER 
PRINT 


This program prints the Atari characters in their default colors for text rnodes 
0, 1, and 2. In enterine; this proeram, remember that the clear screen Symbol 
“-*l” is printed as “ } ”, 


1 DIM A$< 1 > 

5 ? ■REM CLEAR SCREEN 

18 ? "GRAPHICS 0, 1, AND 2 (TEXT MÜDES)" 

20 ? "DEMONSTRATION." 

30 ? "DISPLAYS CHARACTER SETS FOR EhCH M 

ODE." 

60 HAIT=1000 : REM SUBROUTINE LINE NUMBER 
70 CHBAS=756■REM CHARACTER BASE ADDRESS 
80 UF’PER=224= REM DEFAULT FOR CHßftS 
90 L0WER=22b : REM LOWER CAbE LETTERb & GR 
APHICS 

95 GOSUB HAIT 

100 FOR L=0 TO 2 

112 REM USE £ = FOR GRAPHICS 8 

115 IF L=0 THEN OPEN "E •"=GGTO 11 

ö 

w 

116 REM USE S : FOR GRAPHICS 1 AND 2 

117 OPEN #1,8.«8> "3 : " 

118 GRAPHICS L 

128 PRINT "GRAPHICS ”;L 

130 FOR J=8 TO 7=REM 8 LINES 

140 FOR 1=8 TO 31 - REM 32 CHARSAINE 

158 K=32£J+I 

155 REM DON'T DISPLAY "CLEAR bUREEN" OR 
"RETURN" 


168 

IF K=ASC<: 

) OR K=155 THEN 188 

165 

IF L=0 THEN PUT #1,ASCC" ") •• REM ESC 

PE 



178 

PUT #1, KU REM 

DISPLAY CHARS 

180 

NEKT I 


198 

PRINT #1;" " 

REM END OF LINE 

280 

IF L<>2 OR J-: 

>3 THEN £48 

218 

REM SCREEN FL 

LL 

228 

GOSUB WATT 


230 

PRINT 41;"}"= 

REM CLEAR SCREEN 

248 

NEXT J 


259 

GOSUB WAIT 


265 

PRINT "LOWER 

CA3E AND GRAPHICS" 

278 

IF L<>8 THEN 

POKE CHBAS,LOWER = GOSUB 

WA IT 


275 

CLOSE #1 


280 

NEXT L 


308 

GRAPHICS 8 = Er- 

ID 


1000 REM WATT FOR "RETURN" 

1018 PRINT "HIT RETURN TO CONTINUS"; 

1020 INPUT hI 
1030 RETURN 
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UNITED STATES 
FLAG 


This program involves Switching colors to set up the stripes. It uses graphics 
mode 7 plus 16 so that the display appears as a full-screen. Note the cor- 
respondence of the COLOR Statements with the SETCOLOR Statements. For fun 
and experimentation purposes, add a SOUND Statement and use a READ/DATA 
combination to add “The Star Spangled Banner” after line 470. (Refer to Section 
10 .) 


10 REM DRAU THE UNITED STATES FLAG 
20 REM HIGH RESOLUTION 4-CÜLÜR GRAPHICS, 
NO TEXT WINDOW 
30 GRAPHICS 7+16 

40 REM SETCOLOR 9 CORRESPONDS TO COLOR 1 


50 SETCOLOR 8,4,4=RED=1 

69 REM SETCULÜR 1 CORREsPuNDS TO COLOR 


70 SETCOLOR 1,0,14=WHITE=2 
80 REM SETCOLOR 2 CORRESPONDS 


TO COLOR 


90 BLUE=3 REM DEFAULTS TO BLUE 

100 REM ORAW 13 RED & WHITE STRIPES 

110 C=RED 

120 FOR 1=0 TO 12 

130 COLOR C 

140 REM EACH STRIF'E HAS SEUERAL HORIZONT 

AL LINES 

150 FOR J=8 TO 6 

160 PLOT 0,I*7+J 

170 DRAWTO 159, I&7+J 

180 NEXT J 

199 REM SWITCH COLORS 

200 C=C+1 : IF OWHITE THEN C=RED 
210 NEXT I 

390 REM DRAN BLUE RECTANGLE 

310 COLOR BLUE 

320 FOR 1=8 TO 48 

330 PLOT 0,1 

348 DRAWTO 79,1 

358 NEXT I 

368 REM ORAW 9 ROWS OF WHITE STARS 
378 COLOR WHITE 

380 K=0 : REM START WITH RGW OF 6 STARS 
390 FOR 1=0 TO 8 
395 Y=4+I#5 

400-FO R J=8 TO 4=R E M 5 ST ARS IN A ROW ~ 
410 X=K+5+J*14 : GOSUB 1888 
420 NEXT J 

430 IF KO0 THEN K=8= GOTO 478 

448 REM ADD 6TH STAR EUERY OTHER LINE 

458 X=5+5*14 : GOSUB 1888 

460 K=7 

470 NEXT I 

508 REM IF KEY HIT THEN STOP 
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SEAGULL OVER 
OCEAN 


This program combines graphics and sounds. The sounds are not “pure” 
sounds, but simulate the roar of the ocean and the gull’s “tweet”. The graphics 
Symbols used to simulate the gull could not be printed on the line printer. Enter 
the following characters in line 20. 


20 BIRD$ = “ V— ” 


To get these Symbols, use (H^G, BE§F, BJJJ R, QE9 R. 


10 Olfl BIRDK4) 

20 BIRÜ$=" 

30 FLAG= 1 : R0W= 10: C0L=18 
40 GRAPHICS 1 : POKE 756,226:P0K£ 752,1 
50 SETCOLOR Ö,ö,0:SETCOLOR 1,8,14 
60 PRINT $£.; 11 ths ocöin" 

70 R=INT(RND<8>*11> 

80 POSITION 17,17 


90 FOR T=0 TO 10 

100 SOUND 8,T,8,4 

110 FOR A=1 TO 50 ; NENT h 

120 IF RND(8)>8.8 THEN FOR D-10 TG 5 

P — 1 : hOuNü 1,0,10,1 NT 1 .. RriO 1 -. U)1 y.) : NEc. 

SOUND 1,0,0,8 

138 GOSüS 280 

140 NENT T 



150 FOR T=10 TO 8 STEP -1 

160 SOUND 8,T,S,4 

178 FOR A=1 TO 50:NENT A 

175 IF RND< ö »0.8 THEN FOR 0=10 TO 5 STE 

P -1:SOUND 1,0,16,8:NENT 0:SOUND 1,0,0,0 


180 FOR H=1 TO 18:NENT H 

185 GOSUB 288 

190 NENT T 

195 GOTO 78 

200 GOSUB 388 

218 POSITION COL,RON 

228 PRINT #6; BIRD$( FLAG, FLAG+1 

230 FLAG=FLAG+2:IF FLAG=5 THEN 

240 RETURN 

380 IF RNlX0»8.5 THEN RETURN 
318 POSITION COL,RON 
328 PRINT #6;" " 

338 A=INT( RNfKO 5*3 )-l 

340 B=INTCRNDC8)*3)-1 

350 ROW=RÜw+A 

368 IF RQW=0 THEN R0N=1 

378 IF R0N=28 THEN R0W=19 

388 UOL=UüL+B 

398 IF C0L=8 THEN C0L=1 

408 IF COL>18 THEN C0L=18 

418 RETURN 
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300 

c 

FOR 1=8 TO JOYMAN : REM 

L’HEUK 

JOY 

'STICK 

305 

REM CHECK TRIGGER 




318 

IF STRIG(I) THEN 321 




311 

IF A< >8 THEN 320 




312 

COLRC I )=COLR( I Hl : IF C 

OLRCI 


THEN 

CDU 

:(I )=0 : REM 2-C0L0R MODE 




313 

GOTO 321 




320 

COLRC I >=COLR< I Hl IF C 

OLRCI 

»=4 

[ THEN 

COLRCI)=0 : REM 4-C0L0R H0D 

r“ 



321 

IF J>0 THEN COLOR COLR 

C I > : GC 

JTO 

325 

322 

IF COLRCI)=0 THEN COLO 

R 1:GOTO 

325 

323 

COLOR 8 : REM BLINK CURRENT SC 

ÄJARE ON 

AND 

OFF 




325 

PLOT NCD..YCD 




338 

JOYIN=3TICKCI> : REM REA 

0 JOY:: 

STIC 

;k 

348 

IF JOYIN=15 THEN 530 : REM NO 

NO 1 , 

-EMENT 

342 

COLOR COLRCI) : REM MAKE 

üURE 

COLOR IS 

ON 





344 

PLOT NC I )/y'( I) 




358 

IF JOYIN>=8 THEN 390 




368 

NC I )=NC I Hl: REM MOUE R 

IGHT 



365 

REM IF OUT OF RANGE THEN WRAPAF 

iOUND 

378 

IF NC I )>=NMAN THEN NC I 

>=0 



388 

GOTO 438 




398 

IF JOYIN>=12 THEN 430 




400 

NC I}=N<I>-l'REM MOUE L 

EFT 



410 

IF NC IX0 THEN NC I >=NM 

A»..« i 

Ha“ i 



438 

IF JOYINC>5 AND JOYINC 

>9 AND JC 

5 YI NC > 

13 THEN 478 




448 

Y( I .-‘— Yc I >+l ; Ih YCI >>=YMhN THcN 

Yc I ) = 

0 : REM MODE DOWN 




468 

GOTO 590 




478 

IF JOYINC >6 AND JOYINC 

>1J Ai 

ii“, 

•iU 

JOYINC 

>14 

THEN 588 




488 

YC I )=YC I >-i: IF YC I >C0 

THEN ’ 

Jf T ■ 
i \ L < 

:‘=YMA/< 

-1 : REM MODE UP 




508 

PLOT NC I )/i’C I > 




538 

NENT I 




535 

NENT J 




540 

GOTO 295 
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TYPE-A-TUNE 


This program assigns musical note values to the keys on the top row of the 
keyboard. Press only one key at a time. 


KEY 


INSERT 

CLEAR 


o 

9 

8 

7 

6 

5 

4 

3 

2 

1 


MUSICAL VALUE 

B 

ßl> (or Aff) 

A 

A\> (or G#) 

G 

Fff (or G !>■) 

F 

E 

B b (or Dff) 

D 

Dl> (or Cff) 

C 


TYPE-A-TUNE 


10 Din CHORDC 37).. TUNEC12) 

20 GRAPHICS 0 : ? = ? " 

PROGRAM" 

25 ? = ? "PRESS KEYS l-3,8,<,> TO PRODUCE 
NOTES."; 

27 ? "RELEASE OHE KEY BEFORE PRESSING TH 
E NEXT." 

28 ? "OTHERWISE THERE MAY BE A DELAY." 

30 FOR X=1 TO 37 : READ A : CHORDCX)=A : HEXT 
X 

40 FOR X=1 TO 12 = READ A=TUNECX>=A=NEXT X 


50 OPEN #1,4,0,"K=" 

55 ÖLDCHR=-i 

60 A=PEEK( 764 > = IF A=255 THEN 68 
63 IF A=0LDCHR THEN 108 
65 ÜLDuHR=A 

70 FOR X=1 TO 12=IF TUNEC X>=A THEN SOUND 
0,CHORDCX),10,8=GOT0 100 
80 NEXT X 

100 I=INTCPEEKC53775)-'4> : IF < I/2)=INTC 1/ 
2) THEN 60 

110 F’QKE 764,255 = SOUND 0,0,0,0 = OLOCHR=-1 
=GOTO 60 

208 DATA 243,238,217,204,133,182,173,162 
,153,144,136,123,121,114,188,182,36,31,8 
5,81,76,72,68,64,68 

218 DATA 57,53,58,47,45,42,48,37,35,33,3 
1,23 

220"DATA 31,30,26,24,23,27,51,53,48,58,5 

4,55 


To play “Mary Had A Little Lamb” press the following keys: 


5, 3, 1, 3, 5, 5, 5 3, 3, 3 5, 8, 8 


5 , 3 , 1 , 3 , 5 , 5 


5 , 5 , 3 , 3 , 5 , 3 , 1 
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73S IF BOUROl THEN 888 
748 BOUK-0 ; Bftb'S = ö 
756 THHÜ7=THN07+1 
760 IF THH0TO5 THEH 886 


765 

THN0T= 

i 

i 






770 

DTO-riTHi -< 

r 1 ft-r in+i 






"Wifi 

i ob 

IF RTF: 

-1 i'' 

THEN 

RTF: 

= 1 



790 

CHORO= 

LiNt'% PTK 

) 




888 

RETURN 







1000 

DATA 

162 

, 144, 

136, 

144 

,121,108, 

182,18 

8,108,96,9 

1,96 





1818 

DATA 

':H7 

.»1 o2 .i 

162 




1828 

DATA 

* J 
1 J i 

,i,i. 

•"t *“i 


,1,1,1,1, 

7 O 1 
.> ü_ .« i .* 

1033 

DATA 

6y ,* 

56,47 

H •" 
'i-Ll 

48, 



1848 

DATA 

fey .• 

58,45 

.H •“ 

48, 

33,29 


1058 

DATA 

O i .» 


C“? 

,* w1 ? 

E’” 1 

.J.jt » 

45,48 


2088 

PKiNl 

#6 

. nn t l i 

• rKin 

T #6 

•PR 

INT #6 


2085 

PRINT 

#6 

. !t 

ÜCnViK 

uter" 


2806 

PRINT 

#6 






2818 

PRINT 

#6 

. H 


Bl 

u«ss" 


2838 

RETURN 
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APPENDIX I 


MEMORY 

LOCATIONS 


Note: Many of these locations are of primary interest to expert programmers and are included here as a 
convenience. The labels given are used by Atari programmers to make programs more readable. 



DECIMAL 

HEXADECIMAL 

LABEL 

LOCATION 

LOCATION 

APPMHI 

14,15 

DE 

RTCLOK 

18,19,20 

12,13,14 

SOUNDR 

65 

41 


77 


LMARGIN, 

RM ARGIN 

82,83 

52,53 

ROWCRS 

84 

54 

COLCRS 

85,86 

55,56 

OLDROW 

90 

5A 

OLDCOL 

91,92 

5B 


93 

5C 

NEWROW 

96 

60 

NEWCOL 

97,98 

61,62 

RAMTOP 

106 

6A 

LOMEM 

128,129 

80,81 

MEMTOP 

144,145 

90,91 

STOPLN 

186,187 

BA,BB 

ERRSAV 

195 

C3 

PTABW 

201 

C9 

FRO 

212,213 

D4,D5 


COMMENTS AND DESCRIPTION 

Highest location used by BASIC (LSB, MSB) 

TV frame counter (1/60 sec.) (LSB, NSB, MSB) 
Noisy I/O Flag (0 = quiet) 

Attract Mode Flag (128 = Attract mode) 

Left, Right Margin (Defaults 2, 39) 

Current Cursor row (graphics window). 

Current Cursor column (graphics window). 

Previous Cursor row (graphics window). 

Previous Cursor column (graphics window). 

Data under Cursor (graphics window unless mode 

0 ). 

Cursor row to which DRAWTO will go. 

Cursor column to which DRAWTO goes. 

Actual top of memory (number of pages). 

BASIC low memory pointer. 

BASIC top of memory pointer. 

Line number at which STOP or TRAP occurred 
(2-byte binary number). 

Error number. 

Print tab width (defaults to 10) 

Low and high bytes of value to be returned to 
BASIC from USR function. 
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DECIMAL 

HEXADECIMAL 


LABEL 

LOCATION 

LOCATION 

COMMENTS AND DESCRIPTIONS 

PORTA 

54016 

D300 

PIA Port A Controller Jack I/O ports. 

PORTB 

54017 

D301 

PIA Port B Initialized to hex 3C. 

PACTL 

54018 

D302 

Port A Control Register (on Program Recorder 52 
= ON, 60 = OFF).' 

PBCTL 

54019 

D303 

Port B control register. 

SKCTL 

53775 

D20F 

Serial Port control register. Bit 2 = 0 (last key still 
pressed). 
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INDEX 


A Abbreviations, 4-5 

Commands in headings, 4 
ABS, 33 
adata, 5 
ADR, 35,63 
aexp,4 
aop, 4 

Array, 3-1, 41 
ASC, 37 

ATASCII, 5, 40, C-l through C-6 
ATN, 34 

Audio track of cassette, 23 
avar, 4 

B BASIC, 1 

Blanks (see Spaces) 

Booting DOS, 25 
Braces, 4 
Brackets, 4 
Branching, 

Conditional Statements, 19 
Unconditional Statements, 17 
Brightness (see Luminance) 

Bubble Sort Program, H-5 
Buzzer, 14 
Deferred Mode, F-l 
Direct Mode, 14 
BYE, 9 

C C-Scale Program, 58 

Central Input/Output Subsystem, 23 
Character 

Assigning Color to, 54 
ATASCII, C-l through C-6 
Display at specified locations, 46, 47 
Set, internal, 55 
Sizes in Text modes, 46 
Chaining Programs, 30 

Checkbook Balancer Program, H-l through H-4 
CHR$, 58 

CIO (see Central Input/Output Subsystem) 6 
CLEAR key, 6 
Clear Screen, 

Deferred mode, 5, 14, 46 
Direct mode, 6, 46 
CLOAD, 24 
CLOG, 33 
CLOSE, 27 
CLR, 43 
Codes, 

Device, 23-24 
Colons, 3, 61 
COLOR, 48 


Color 

Assigning, 54 
Changing, 50 
Default, 46, 51 
Registers, 50 
COM (see DIM) 

Computer Blues Program, H-16 
cmdno, 30 
Comma, 26, 27 
Command Strings, 1 
Commands 
BYE, 9 
CONT, 9 
END, 9 
LET, 10 
LIST, 10 
NEW, 10 
REM, 10 
RUN, 11 
STOP, 11 
Conservation, 

Memory, 61 
Constant, 2 
CONT, 9 
Controllers, 

Game, 59 
COS, 34 
CSAVE, 24 
Cursor, 9 
Graphics, 49 
Inhibit, 46 

D Decimal/Hexadecimal Conversion Program, H-18 
Default 
colors, 46 
disk drive, 24, 29 
margins in Mode 0, 46 
tab settings, 6 
Deferred mode, 5 
DEG, 35 
Devices, 23-24 
Delete line, 13 
DIM, 41 
Direct mode, 5 
Disk Drive 

Default number, 24, 29 
Requirements (see ATARI DOS Manual ) 

Disk file 

Modification of BASIC program, 31 
Display, split-screen Override, 45, 47 
Distortion, 57 
DOS, 25 
DRAWTO, 48 
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Keyboard Controller Program, H-14 
Keys 

Special Function 
ATARI, 5 
BACK SPACE, 6 
BREAK, 6 
CAPS/LOWR, 5 
CLEAR, 6 
DELETE, 6 
ESCAPE, 5 
INSERT,6 
RETURN, 6 
SYSTEM RESET, 6 
TAB, 6 
Editing 

CTRL (Control) Key, 13 
SHIFT key, 13 
Cursor Control, 14 
Down arrow, 14 
Left arrow, 14 
Right arrow, 14 
Up arrow, 14 
Keywords 

BASIC, A-l through A-5 

L LEN, 38 

LET, 2, 3, 10 
Letters 

Capital (upper case), 3 
Lower case, 3, 47 
lexp, 4 

Light Show Program, H-8 
Line 

Format, 3 
Logical, 2 
Numbers, 3 
Physical, 2 
lineno, 5 
LIST, 10 
LOAD, 26 

Load program from cassette tape, 24 
LOCATE, 48 
LOG, 34 
Loops 
Endless, 17 
Nested, 15 
lop, 4 

LPRINT, 26 
before CSAVE, 24 
Luminance, 50 

M Mandatory # Symbol, 26, 27 
Margins 

Changing, 36, 46 
Default in mode 0, 46 
Matrix, 41-42 
Variable, 4 

Memory Map, D-l through D-2 
Modes, graphics, 46, 47 
Modes, operating 
Deferred, 5 
Direct, 5 
Execute, 5 
Memo Pad, 5, 25 


Modes, text, 46 
Override split-screen, 47 
Multiple commands (see 
Command Strings) 
mvar, 4 

N NEW, 10 
Notations 
floating point, 39 
in manual, 3 

O ON/GOSUB, 20 
ON/GOTO, 20 
OPEN, 26-28 
Operators, 2 
Arithmetic, 4, 6 
Binary, 6, 7 
Logical, 4, 6 
Relational, 7 
Unary, 6 

Output devices, 23 

Oversized programs (see Chaining Programs) 

P Paddle Controller, 59 
Parentheses, 

Usage, 7, 63 
PEEK, 35 

Peripheral devices (see Input/Output Devices) 
Pitch 

Definition, 57 
Values, 58 
Pixel, 48 

Size in modes, 47 
PLA, 63 
PLOT, 49 
POINT, 28 
POKE, 35 
POP, 20-21 
POSITION, 49 
Precedence, operator, 7 
PRINT, 3, 5, 14, 26 
Printer listing, 10 
Program continuation, 11 
Programs, 

Machine language, 67 
User, Appendix H 
with Hexcode Loader, 65, 66 
PUT, 49 

Q Question mark as prompt, 25 
Quotation marks, 2 

R RAD, 35 

RAM (Random Access Memory), 23 
Random Access to disk file, 28 
READ, 28 
Direct mode, 28 
REM, 10 
RESTORE, 21 
RETURN Key, 6 
Return, Abnormal (see POP) 

Rollover, 

Keyboard, 8 
RND, 34 
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TABLE OF MODES 
AND SCREEN FORMATS 


Gr. 

Mode 

Mode 

Type 

Horiz. 

(Columns) 

Vert. (Rows) 
Split 
Screen 

Vert. (Rows) 
Full 
Screen 

tfOf 

Colors 

RAM 

Required 

(Bytes) 

0 

TEXT 

40 

- 

24 

2 

993 

1 

TEXT 

20 

20 

24 

5 

513 

2 

TEXT 

20 

10 

12 

5 

261 

3 

GRAPHICS 

40 

20 

24 

4 

273 

4 

GRAPHICS 

80 

40 

48 

2 

537 

5 

GRAPHICS 

80 

40 

48 

4 

1017 

6 

GRAPHICS 

160 

80 

96 

2 

2025 

7 

GRAPHICS 

160 

80 

96 

4 

3945 

8 

GRAPHICS 

320 

160 

192 

1/2 

7900 


MODE, SET COLOR, COLOR TABLE 


Default 

Colors 

Mode or 
Condition 

SETCOLOR 

(aexpl) 

Color 

Register No. 

Color 

(aexp) 

DESCR1PTION AND COMMENTS 



0 

COLOR data 

_ 

LIGHT BLUE 

MODE 0 and 

1 

actually 

Character luminance (same color as background) 

DARK BLUE 

ALL TEXT 

2 

determines 

Background 


WINDOWS 

3 

character to 

— 

BLACK 


4 

be plotted 

Border 

ORANGE 


0 

COLOR data 

Character 

LIGHT GREEN 

MODES 1 

1 

actually determines 

Character 

DARK BLUE 

and 

2 

character to be 

Character 

RED 

2 

3 

plotted 

Character 

BLACK 

(Text Modes) 

4 


Background, Border 

ORANGE 


0 

1 

Graphics point 

LIGHT GREEN 

MODES 3, 5, 

1 

2 

Graphics point 

DARK BLUE 

and 7 

2 

3 

Graphics point 


(Four-color 

3 

- 

— 

BLACK 

Modes) 

4 

0 

Graphics point (background default), Border 

ORANGE 

MODES 4 

0 

1 

Graphics point 


and 6 

1 

- 

— 


(Two-color 

2 

- 

— 


Modes) 

3 

- 

— 

BLACK 

4 

0 


Graphics point (background default), Border 

LIGHT GREEN 


0 


_ 

DARK BLUE 


1 

1 

Graphics point luminance (same color as background) 


MODE ß 

2 

0 

Graphics point (background default) 


(1 Color 

3 

- 

— 

BLACK 

2 Luminances) 

4 

- 

Border 
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CONTROL GRAPHICS KEYBOARD 









E Editing, screen, 13 
Editor, Screen, 24 
END, 9 

before subroutine, 7 
End of file, 14 

Error messages, B-l through B-3 
Escape key, 5 

with Control Graphics Symbols, F-l 
EXP, 33 
exp, 5 

Exponentiation symbol, 6 
Expression, 1 
Arithmetic (see aexp) 

Logical (see lexp) 

String {see sexp) 

F filename, breakdown, 27 
filespec, 5 
Usage, 26, 27 
Fill (XIO), 54 
FOR/NEXT, 15 

building arrays and matrices, 42 
with STEP, 15 
without STEP, 15 
FRE, 35 
Function, 1 
Arithmetic 
ABS, 33 
CLOG, 33 
EXP, 33 
INT, 33 
LOG, 34 
RND, 34 
SGN, 34 
SQR, 34 
Built-in, 7 
Derived, E-l 
Library, 33 
Special Purpose, 35 
ADR, 35 
FRE, 35 
PEEK, 35 
POKE, 35 
USR, 36 

Trigonometrie, 34 
ATN, 34 
COS, 34 
DEG, 35 
RAD, 35 
SIN, 35 

G Game Controllers 
Keyboard, 59 
Joystick, 59 
Paddle, 59 

Video Graffitti program, H-12 through H-13 
Game Controller commands 
PADDLE, 59 
PTRIG, 59 
STICK, 59 
STRIG, 60 
GET, 28, 49 

GOSUB/RETURN, 16, 21 


GOTO, 17 

with conditional branching, 17 
GRAPHICS, 45 
Graphics 
Modes, 46-47 
Statements, 48 
COLOR, 48 
DRAWTO, 49 
GET, 45 
GRAPHICS, 48 
LOCATE, 48 
PLOT, 49 
POSITION, 49 
PUT, 49 
SETCOLOR, 50 
XIO (Fill), 54 

Graphics Control Characters, 56 

H Harmony, 57 
Hexadecimal 

/Decimal Conversion Program, H-18 
Hexcode Loader program, 64 

I INPUT, 25 

Input/Output Commands, 23 
CLOAD, 24 
CLOSE, 27 
CSAVE, 24 
DATA, 28 
DOS, 25 
ENTER, 25 
GET, 28 
INPUT, 25 
LOAD, 26 
LPRINT, 26 
NOTE, 26 
OPEN, 26 
POINT, 28 
PRINT, 3, 5, 14, 26 
PUT, 28 
READ, 28 
SAVE, 29 
STATUS, 29 
XIO, 29 

Input/Output Devices 
Disk Drives (D:), 24 
Keyboard (K:), 23 
Line Printer (L:), 23 
Program Recorder (C:), 23 
RS-232 Interface (R:), 24 
Screen Editor (E:), 24 
TV Monitor (S:), 24 
INT, 33 

Internal pointer for DATA, 21 
Input/Output Control Block, 23 
Inverse Key, 5 

Invisible graphics Cursor, 48-49 
IOCB (see Input/Output Control Block) 

J Joystick Controller, 59 

K. Keyboard (K:), 23 

Keyboard Controllers, 59 
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NOTES 


Notes 




DECIMAL 

HEXADECIMAL 

LABEL 

LOCATION 

LOCATION 

RADFLG 

251 

FB 

LPENH 

5G4 

234 

LPENV 

5G5 

235 

TXTROW 

G5G 

290 

TXTCOL 

657,658 

291,292 

COLORO 

708 

2C4 

COLOR1 

709 

2C5 

COLOR2 

710 

2C6 

COLOR3 

711 

2C7 

COLOR4 

712 

2C8 

MEMTOP 

741,742 

2E5,2E6 

MEMLO 

743,744 

2E7,2E8 

CRSINH 

752 

2F0 

CHACT 

755 

2F3 

CHBAS 

756 

2F4 

ATACHR 

763 

2FB 

CH 

764 

2FC 

FILDAT 

765 

2FD 

DSPFLG 

766 

2FE 

SSFLAG 

767 

2FF 

HATABS 

794 

31A 

IOCB 

832 

340 


1664-1791 

680-6FE 

CONSOL 

53279 

D01F 


* Future product. 


COMMENTS AND DESCRIPTIONS 

RAD/DEG flag (0 = radians, G = degrees). 

Light Pen* Horizontal value. 

Light Pen* Vertical value. 

Cursor row (text window) 

Cursor column (text window) 

Color Register 0 
Color Register 1 
Color Register 2 
Color Register 3 
Color Register 4 

OS top of available user memory pointer (LSB, 
MSB) 

OS low memory pointer 

Cursor inhibit (0 = Cursor on, 1 = Cursor off) 

Character mode register (4 = vertical reflect; 2 = 
normal; 1 = blank) 

Character base register (defaults to 224) (224 = up- 
per case, 22G = lower case characters) 

Last ATASCII character. 

Last keyboard key pressed; internal code; (255 
clears character). 

Fill data for graphics Fill (XIO). 

Display Flag (1 = display control character). 

Start/Stop flag for paging (0 = normal listing) Set by 

i. 

Händler address table (3 bytes/handler) 

I/O control blocks (IG bytes/IOCB) 

Spare RAM 

Console switches (bit 2 = Option; bit 1 = Select; bit 
0 = Start. POKE 53279, 0 before reading. 0 = 
switch pressed.) 
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DECIMAL/ 

HEXADECIMAL 

CONVERSION 

PROGRAM 


This program can be typed in and used to convert hexadecimal numbers to 
decimal numbers and vice versa. 


19 Din AK 9 >.' ADK 1 > 


28 i 

GRAPH! 

"Ml; iv» ; *7 ; 7 

n 

HEX 

NUMB 

ER CO 

i ti i 

fiV 

ERS 

IONS": 







30 ' 

. *”• H 

Enter 'D* 

for 

DEC t 

o HEX 

cono 

er 

Sion.";? 

"Enter 'H 

1 for 

HEX 

to DEC con 

Me 

rsii 

on."=INPUT AI 






48 

IF LEN 

(AI >=8 TH! 

Eli 30 





50 

IF Al- 

"H" THEN ' 

388 





6 @ 

IF AK 

>"0” THEN 

■ 7 # 

■j 





98 ' 

TRAP 9 

"J 






109 

t' 1 t 

"ENTER A 

DEC IN 

!AL NUMBER 

FRON 

8 

THRi 

OUGH 9 

993939993 

M 





110 

? "DE 

C i : INPü 

T N 





12 'ü 

IF N< 

8 0R N>=1 

Eh-18 

THEN 

ijj i Ü 

100 


138 

1=9 







148 

TEMF- 

N-N=INT(N 

-•'16 > 





158 

TEMF- 

TEN?-NX 16 






168 

Tr Trwr ; / < o TUET 

i r ici ir i k> >Hc 

N AK 

T T *. 

1 1 

STRK 

TEMP) 

! : G 

OTO 

188 







178 

AK I .■ 

I)=CHRICT 

rMp_ i 

0+A3C 

("A"; 

I ) 


180 

IF H< 

>8 THEN I 

= 1 - 1 : 

GOTO 

148 



190 

? "HE 

" i AK I 

t *7 ? • V 





288 

GOTO 

110 







300 TRAP 380 

:? "ENTER A HEX NUMBER FRON 8 THRÖ 
FFFFFFFF." 


310 

UGH 


328 

V’ 11 

HEX : 

;i . 

/ 

: INPUT 

AI 


338 

N=0 






348 

FOR 

T — H 
1-1 

T 

J 

0 LEN( 

AI) 


345 

ADI 

=ft$< 

T 

I): IF 

ADK "0" 

THtH 3m 

*7 c<“j 

IF 

AK I 

T 
; i 

>(="9" 

THEN N : 

-NX 1 6+UAL 

: GOT0 378 





355 

IF 

ADK 

1! A 

" THEN 

308 


357 

IF 

ADI) 

"F 

" THEN 

388 


368 

N=N 

• : 7 1 

C(ADI) 

~HblÄ "A’ 

! )+i0 

370 

HEX 

T I 





380 

*7* 11 

DEC : 

>1 

i H : ? 




398 GOTO 328 
408 END 
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COMPUTER 

BLUES 


This program generates random musical notes to “write” some very interesting 
melodies for the programmed bass. 


1 GRAPHICS ü=? : ? " COMPUTER BLUE 

C» • ‘7 

2 PTR=1 

3 THN0T=1 

5 CHORD-1 

6 PRINT "BASS TEMPO <1=FAST>'‘; 

7 INPUT TEMPO 

8 GRAPHICS 2+16 : G0SUB 2800 


10 

01M 8ASE<3,4> 



28 

DIN LOl'K 3 > 



“iC 

£..j 

DIU LIHE( 16) 



26 

OIM JAN(3,7) 



38 

FOR X=1 TO 3 



40 

FOR Y=1 TO 4 



50 

READ A : BASEc X , Y ; ,= A 



68 

HEXT Y 



70 

HEXT X 



88 

FOR X=i TO 3 : READ A : ' 

UMX 

)=H 

30 

HEXT X 



35 

FOR X=1 TO 16=READ ft 

LINE' 

: X >=A 

36 

FOR X=1 TO 3 



37 

FOR Y-l TO 7 



38 

READ h : JAMC X , Y ) = A : NE! 

XT Y:HEXT : 

100 

IjOSUB 588 



110 

T=T+1 



115 

GOSUB 280 



120 

GOTO 108 



280 

REM PRGCESS HIGH STOFF 


205 

IF RHO 1 ’. 8 X 8.25 THEN 

RETURN 

210 

IF RHEK8X8.5 THEN 

250 


228 

HT=NT+1 



238 

IF NT >7 THEN HT=7 



248 

GOTO 268 



258 

HT=HT-1 



255 

IF HT<1 THEN HT=1 



268 

SOUND 2,JAM(CH0RD,N 

i X 18. 

, MTY2 

OSd"-i 

ciod 

RETURN 



500 

REM PROCESS BASE ST! 

UFF 


518 

IF BASS=1 THEN 788 



520 

B0UR=B0UR+1 



538 

IF BDUROTEMPO THFH 

535 


531 

BASS=1 : BOUR-8 



535 

SOUND 8L0WCCHQRD.N 

18,4 


548 

SOUND LBASECCHORD,' 

Ti” h~.T 

\ rfriu i 

10, . 

558 

RETURN 



708 

SOUND 0,6.. 8,8 



718 

SuUND IjÖ.>8,8 



728 

BOUF-BÖUR+1 
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KEYBOARD 

CONTROLLER 


This program alters registers on a chip called a PIA. To set these back to the 
default values in order to do further I/O, hit EESSESäi or POKE PACTL,60. If 
this program is to be loaded from disk, use LOAD, not RUN and wait for the 
busy light on the disk drive to go out. Do not execute the program before this 
light goes out, otherwise the disk will continue to spin. 


1 GRAPHICS 0 

5 PRINT :PRINT " KEYBOARD CONTROLLER 
DEMO" 

10 Din RO MC 3 >, IS< 13 >, BUTTON« 1) 

30 GOSUB 6080 
40 FOR CNT=1 TO 4 

60 POSITION 20 CNT$2+5 : PRINT "CONTROLLER 
# ";CNTi" : "; 

70 HEXT CNT 

80 FOR CNT=1 TO 4=GOSUB 7308 : POSITION 19 
,CNT+CNT+5*PRINT BUTTONS; =NEXT CNT 
120 GOTO 88 


6000 REH U SET UP FOR CONTROLLERS U 
6010 PORTA=54016:PORTB-54017 = PACTL=54018 
: PBCTL=54019 

6020 POKE PACTL/48 : POKE PORTh > 255 1 POKE P 

ACTLj 52 : POKE PORTA.-221 

6025 POKE P8CTL/48 : POKE PORTEN 255 POKE P 

BCTL,52*P0KE PORTS/221 

6030 ROWC 0 )=238 = ROfcK 1 )=221 •• RÖW( 2 )= 187 = RO 


W<3>=119 


6040 I$=" 12345678913#" 

6050 RETURN 

7000 REM U RETURN BUTTONS NITH CHARACTE 
R FOR BUTTON WHICH MAS BEEN PRESSER ON C 
0NTR0LLER CNT (1-4). U 


7001 REM U NOTE* A 1 WILL BE RETURNED I 
F NO CONTROLLER IS CONNECTED. U 
32 REN U A SPACE WILL BE RETURNED IF 


THE CONTROLLER IS CONNECTED SUT NO KEY H 
AS BEEN PRESSED. U 

7803 PÖRT=P0RTA : IF CNT>2 THEN P0RT=P0RTB 


7005 P=1 

7008 PAD=CMT+CNT-2 
7010 FOR J=0 TO 3 
7020 POKE PORT..ROWCJ) 

7030 FOR 1=1 TO 10*NEXT I 

7050 IF PADDLE<PAD+1»18 THEN P=J+J+J+2= 

GOTO 7890 

7060 IF PADOLE(PAD)>10 THEN F-J+J+J+3 : LU 
TO 7098 

7070 IF bTRlLC uNT- 1)=3 THhN F=J+J+J+4 : UU 

TO 7098 

7088 NEXT J 

7098 BlJTT0NS=IS(P..P) 

7095 RETURN 
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VIDEO 

GRAFFITTI 


This program requires a Joystick Controller for each player. Each joystick has 
one color associated with it. By maneuvering the joystick, different patterns are 
created on the screen. Note the use of the STICK and STRIG commands. 


1 GRAPHICS 0 

2 ? "VIDEO GRAFFITI" 

5 REM m ARRAYS HOLD COORDINATES 

6 REN FOR UP TO 4 PLAYERS' POSITIONS. 

7 REN COLR ARRhY HOLDS COLORS. 

10 DIN AtC 1 ).X(3). Y(3), C0LR( 3) 

128 ? "USE JOYSTICKS TO DRAN PICTURES" 

129 ? "PRESS BUTTONS TO CHANGE COLORS" 

130 ? "INITIAL COLORS 

131 ? »JOYSTICK 1 IS RED" 

132 ? "JOYSTICK 2 IS WHITE» 

133 ? "JOYSTICK 3 IS BLUE" 

134 ? "JOYSTICK 4 IS BLACK (BAUKuRuUND)" 

135 ? "BLACK LOCATION IS INOICATEO BY A 
BRIEFFLASH OF RED." 

136 ? "IN GRAPHICS 8, JOYSTICKS 1 AND 3 
ARE WHITE AND 4 IS BLUE." 

138 PRINT "HÜW NAHY PLAYERS (1-4)"; 

139 INPUT A$ =IF LEN<AI)=0 THEN A*='T' 

140 JÜYMAX=UAL<AI)-1 

145 IF JÖYMAX<0 OR JÜYNAX>=4 THEN 138 
147 PRINT "GRAPHICS 3 (40X24). 5 (88X48) 

II 

158 PRINT "7 (160X96). OR 8 (328X192)"; 

152 INPUT AI : IF LEN<AI)=8 THEN A$= n 3" 

153 A=UhL(AI) 

154 IF A=3 THEN XNAX=48•YNAN=24 : GOTO 159 

155 IF h=5 THEN XNAX=88 : YNAX=48=GOTO 159 


156 IF A=7 THEN HNAX=1S8=YfiAX=36 = GOTO 15 

9 

157 IF h= 8 THEN Xf1AX=328 : YNAX=192 ; GOTO 1 

59 

153 GOTO 147=REN A NOT UALID 
159 GRAPHICS A+16 

168 FOR 1=8 TO JÜYNAN = X(I)=XNAX / 2+1= Y(I) 
=YNhX/ 2+I=NEXT I=REM START NEftR CENTER 0 
F SCREEN 

161 IF A<>8 THEN 166 

162 FOR 1=8 TO 2 = COLR(I)=1= HEXT I 

163 SETCOLOR 1.9.14=REM LT. BLUE 

165 GOTO 180 

166 FOR 1=8 TO 2=C0LR(!)=!+!=HEXT I 

167 SETCOLOR 8.4.6=REN RED 

168 SETCOLOR 1.8.14=REN WHITE 
139 C0LR<3)=8 

295 FOR J=0 TO 3 
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510 IF PEEK< 764 )=255 TBEH 518 

515 REM OPEN TEKT WINDOW MITHÜUT CLEAR 

G SCREEH 

528 GRAPHICS 7+32 

525 REM CHANGE CGLORS BACK 

530 SETCULüR 8 > 4 > 4 : SETUüLüR 1 > 8;14 

550 STOP 

1800 REM DRAN 1 STAR üENTERED AT X/v 
1810 PLOT X-liY : ORAWTO X+1..Y 
1020 PLOT X/r'-l : PLOT N,Y+1 
1030 RETURN 


H-10 Appendix 



LIGHT SHOW 


This program demonstrates another aspect of Atari graphics. It uses graphics 
mode 7 for high resolution and the PLOT and DRAWTO Statements to draw the 
lines. In line 20, the title will be more effective if it is entered in inverse video 
(use the Atari logo key). 


10 FOR ST=1 TO S=GRAPHICS 7 
15 POKE 752,1 

20 ? : ? " Atari's Special Lieht Show 

" : SETC0L0R 2,8,0 

30 SETCÖLGR 1,2£ST,8=CÜLÜR 2 

40 FOR DR=Ö TO 88 STEP ST 

50 PLOT 0,8=DRAWTO 108,DR 

60 HEXT DR = FOR N=1 TO 808 = HEXT H : HEXT ST 
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TED CÖPYV INPUT Bf 

258 IF THEN 400 

300 EHO 

408 1=1sLPRIHT : FOR K=1 TO EMIRIES 
420 IPRINT ;Kj " MW< I, I+SLEN1) 

436 I=I+SLEN : NEKT K- END 

1000 REM STRING BUBBLE SORT ROUTINE 

1010 REM INPUT: AK SLEN,ENTEIES 

1015 REM TEfIPf MUST HAUE A DIMENSION OF 

SLEN. 

1020 SLEN1=SLEN-1 : MAX=SLENKENTRIES-1Hl 


1040 FOR 1=1 TO MAX STEP SLEN 
1050 DÜNE=1 

1060 FOR K=i TO MAX-I-SLEN1 STEP SLEN 
1070 KSLEN1-K+SLEN1 KSLEN=K+SLEN ; KSLENSL 
EN1=KSLEN+SL,EN1 

1080 IF AKK,KSLEN1X=AKKSLEN,KSLENSLEN 
1) THEN GOTO 1118 
1890 DONE=0 

1100 TEMPf=A$< K, KSLEN 1) •• AK KL KSLEN 1 )=AK 
KSLE1L KSLENSLEN 1) : AK KSLEN; KSLhNSLENl )=T 

EMF'f 

1110 NEXT K 

1120 IF DONE THEN RETURN 
1138 HEXT I 
1140 RETURN 
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7080 ? "ENTER V GR H M i* INPUT A$ 

7090 IF LENCA$)=0 THEN END 
7100 IF AK 1,1)="Y" THEN RETURN 
7110 END 

7999 REM NSG PRINTING ROUTINE 

8008 ? MSG$; U I" i AMGUNT 

8010 IF F’ERM=1 THEN LRR INT MSG$;" 

UNT 

8020 RETURN 

8100 REM flSG PRINT fc INPUT ROUTINE 
8110 TRAP 8110=? "ENTER AflÖUNT FÜR ";HSG 
$i ■■ INPUT AMOUNT 
8120 TRAP 48000 

8130 IF PERM=1 THEN LPRINT ÜSGK" K'jfflO 
UNT 

8140 RETURN 
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228 IF A$<1 > 1)="N" THEN 488 
238 IF mlAXy"^ , THEN 288 
248 TRAP 188 

258 LPRINT : REM TEST PRINTER 
268 PERN-1 


288 LPRINT "YOUR BEGINN!HG BALANCE 




YOURBAL 

290 LPRINT "BANK STATEMENT BEGINNING 8AL 
ANCE IS $";8ANK8AL=LPRINT 
480 TRAF’ 408•'? '■'{ “Choose on <2 of t-hs toi 
löwirö : " 


413 


"C1 > 

« . MCf i .*■ 
/ I 5.„»U i •+• 

415 


"i- ■? > 

";MSG2$ 

420 


"(3) 

" } MSG3$ 

425 


"(4) 

";MSG4T 

438 


"(5) 

n . MCt-cr.-f 

435 


"< 6) 

";MSGS$ 

440 

•? 

"(7) 

DOME" 

490 





588 INF’LIT N=IF N<1 DR N>7 THEN 488 
505 TRAP 40098 


518 ON N GOSUB 1088 ..2888 ..3888 >4888 ..5888/ 
6088>7880 

520 MSGf="NEW CHECKBOOK BALANCE IS 

" : AM0UNT=YOURBA;L : GOSUB 8888 

538 riSG$="HEN BANK STATEMENT BALANCE IS 

" : AMUÜNT=BANKBAL : UUSüB 3088 

548 MSG$="OUTSTANDING CHECKS-DEPÜSITS= 

":AMOUNT=ÖUTSTAND=GOSUB 3808 
545 IF PERM THEN LPRINT 
558 GOTO 480 

1000 REM OLD CHECK — STILL OUTSTANDING 
1810 MSG$=MSG1$ : GOSUB 8186 
1020 OUTSTAND=OUTSTANCK AMOUNT 
1830 RETURN 

2006 REM OLD DEPOSIT - STILL HOT CREDIT 

ED 

2810 MSG*=MSG2|:GOSUB 8188 
2028 OUT ST AND=QUTSTAND-AMOUNT 
2830 RETURN 

3008 REM OLD CHECK - JUST CLEARED 
3018 MSG$=MSG3$ ; GOSUB 3138 
3820 BANKBAL=BANKBhL-AMOUNT 
3830 RETURN 

4080 REM OLD DEPOSIT — JUST CREDITED 
4010 MSG$=ttSG4$ = GOSUB 8188 
4020 BAHKBAL=BANKBAL+At10UNT 
4038 RETURN 

5800 REM NEW CHECK COR SERUICE CHARGE? - 
- JUST CLEARED 
5810 flSG$=MSG5$ : GOSUB 3136 
5028 YOURBAL=YOURSAL-AMOUNT 
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Pixel: 


Precedence: 


Program: 


Prompt: 


RAM: 

Random Number 
Generator: 

Reserved Word: 
ROM: 


Save: 

Screen: 

Serial: 

Software: 

Special Character: 

Statement: 


String: 

Subroutine: 

Variable: 

Window: 


Picture Element. One point on the screen display. Size depends on 
graphics mode being used. 

Rules that determine the priority in which operations are conducted, 
especially with regard to the arithmetical/logical operators. 

A sequence of instructions that describes a process. A program must 
be in the language that the particular Computer can understand. 

A symbol that appears on the monitor screen that indicates the Com¬ 
puter is ready to accept keyboard input. In Atari BASIC, this takes the 
form of the word “READY”. A “?” is also used to prompt a user to 
enter (input) Information or take other appropriate action. 


Random Access Memory. The main memory in most Computers. 
RAM is used to störe both programs and data. 

May be hardware (as is Atari’s) or a program that provides a num- 
ber whose value is difficult to predict. Used primarily for decision- 
making in game programs, etc. 

See Keyword. 

Read Only Memory. In this type of solid-state electronic memory, in- 
formation is stored by the manufacturer and it cannot be changed by 
the user. Programs such as the BASIC interpreter and other Car¬ 
tridges used with the Atari Systems use ROM. 

To copy a program or data into some location other than RAM (for ex- 
ample, diskette or tape). 

The TV screen. In Atari BASIC, a particular I/O device codes “S:” 

The opposite of parallel. Things happening only one at a time in se¬ 
quence. Example: A serial interface. 

As opposed to Hardware. Refers to programs and data. 

A character that can be displayed by a Computer but is neither a let- 
ter nor a numeral. The Atari graphics Symbols are special characters. 
So are punctuation marks, etc. 


An instruction to the Computer. See also Command. While all com- 
mands may be considered Statements, all Statements are certainly not 
commands. A Statement contains a line number (deferred mode), a 
keyword, the value to be operated on, and the Q3Q23 command. 


A sequence of letters, numerals, and other characters. May be stored 
in a string variable. The string variable’s name must end with a $. 


A part of a program that can be executed by a special Statement 
(GOSUB) in BASIC: This effectively gives a single Statement the power 
of a whole program. The subroutine is a very powerful construct. 


A variable may be thought of as a box in which a value may be 
stored. Such values are typically numbers and strings. 

A portion of the TV display devoted to a specific purpose such as for 
graphics or text. 
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Computer: 


Concatenation: 

Control Characters: 

CRT: 

Cursor: 

Data: 

Debug: 

Default: 

Digital: 

Diskette: 


DOS: 

Editing: 

Execute: 

Expression: 

Format: 
Hard Copy: 


Any device that can receive and then follow instructions to 
manipulate Information. Both the instructions and the information 
may be varied from moment to moment. The distinction between a 
Computer and a programmable calculator lies in the computer’s abili- 
ty to manipulate text as well as numbers. Most calculators can only 
handle numbers. 

The process of joining two or more Strings together to form one 
longer String. 

Characters produced by holding down the key labeled ISTW while 
simultaneously pressing another key. 

Abbreviation for “cathrode ray tube” (the tube used in a TV set). In 
practice, this is often used to describe the television receiver used to 
display Computer output. Also called a “monitor”. 

A square displayed on the TV monitor that shows where the next 
typed character will be displayed. 

Information of any kind. 

The process of locating and correcting mistakes and errors in a pro¬ 
gram. 

A mode or condition “assumed” by the Computer until it is told to do 
something eise. For example, it will “default” to screen and keyboard 
unless told to use other I/O devices. 

Information that can be represented by a Collection of bits. Virtually 
all modern Computers, especially microcomputers, use the digital ap- 
proach. 

A small disk. A record/playback medium like tape, but made in the 
shape of a flat disk that is placed inside a stiff envelope for protection. 
The advantage of the disk over cassette or other tape for memory 
storage is that access to any part of the disk is virtually immediate. 
The Atari 800 Personal Computer System can control up to 4 diskette 
drive peripherals simultaneously. In this manual, disk and diskette 
are used interchangeably. 

Abbreviation for “disk operating System”. The Software or pro- 
grams which facilitate use of a disk-drive System. DOS is pronounced 
either “dee oh ess” or “doss”. 

Making corrections or changes in a program or data. 

To do what a command or program specifies. To RUN a program or 
portion thereof. 

A combination of variables, numbers, and operators (like +, -, etc.) 
that can be evaluated to a single quantity. The quantity may be a 
string or a number. 

To specify the form in which something is to appear. 

Printed output as opposed to temporary TV monitor display. 
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NOTES 


Notes 



NOTES 


Notes 



ADDRESS 


CONTENTS 


Decimal 

Hexadecimal 


4863 

1792 

12FF 

700 

FILE MANAGEMENT SYSTEM RAM (current DOS) 

1791 

6FF 

FREE RAM 

1536 

600 

1535 

1406 

5FF 

57E 

FLOATING POINT (used by BASIC) 

1405 

57D 

BASIC CARTRIDGE 

1152 

480 

1151 

1021 

47F 

3FD 

OPERATING SYSTEM RAM (47F-200) 

CASSETTE BUFFER 

1020 

3FC 

RESERVED 

1000 

3E8 

999 

3E7 


PRINTER BUFFER 

960 

3C0 


959 

3BF 1 

IOCB’s 

832 

340 J 

831 

512 

33F 1 

200 J 

MISCELLANEOUS OS VARIABLES 


511 

256 

1FF 

100 

HARDWARE STACK 

255 

FF 

PAGE ZERO 

FLOATING POINT (used by BASIC) 

212 

D4 

211 

210 

D3 

D2 

BASIC or CARTRIDGE PROGRAM 

209 

208 

Dl 

DO 

FREE BASIC RAM 

207 

CF 

FREE BASIC AND ASSEMBLER RAM 

203 

CB 


202 

176 

CA 

B0 

FREE ASSEMBLER RAM ) 

I BASIC 

128 

80 

ASSEMBLER ZERO PAGE j ZERO PAGE 

127 

0 

7F 

0 

OPERATING SYSTEM RAM 


As the addresses for the top of RAM, OS, and BASIC and the ends of OS and BASIC vary according to the 
amount of memory, these addresses are indicated by pointers. The pointer addresses for each are defined 
in Appendix I. 
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See Appendix H for a user program that performs decimal/hexadecimal conversion. 


Notes: 

1. ATASCII Stands for “ATARI ASCII”. Letters and numbers have the same values as those in ASCII, but 
some of the special characters are different. 

2. Except as shown, characters from 128-255 are reverse colors of 1 to 127. 

3. Add 32 to upper case code to get lower case code for same letter. 

4. To get ATASCII code, teil Computer (direct mode) to PRINT ASC (“._”) Fill blank with letter, 

character, or number of code. Must use the q[uotes! 

5. On pages C-l and C-3, the normal display keycaps are shown as white Sym¬ 
bols on a black background; on pages C-4 and C-6 inverse keycap symbols 
are shown as black on a white background. 


C-6 Appendix 




C-4 Appendix 



& 
< 4* 

^ c 4 ? 


/f / 

& & 



y 

39 

27 

> 

55 

37 

7 

71 

47 

G 

40 

28 

( 

56 

38 

8 

72 

48 

H 

41 

29 

) 

57 

39 

9 

73 

49 

I 

42 

2A 

* 

58 

3A 

: 

74 

4A 

J 

43 

2B 

+ 

59 

3B 

> 

75 

4B 

K 

44 

2C 


60 

3C 

< 

76 

4C 

L 

45 

2D 

- 

61 

3D 

= 

77 

4D 

M 

46 

2E 

• 

62 

3E 

i 

> 

78 

4E 

N 

47 

2F 

/ 

63 

3F 

p 

79 

4F 

O 

48 

30 

0 

64 

40 

@ 

80 

50 

P 

49 

31 

1 

65 

41 

A 

81 

51 

ft 

50 

32 

2 

66 

42 

B 

82 

52 

R 

51 

33 

3 

67 

43 

C 

83 

53 

S 

52 

34 

4 

68 

44 

D 

84 

54 

T 

53 

35 

5 

69 

45 

E 

85 

55 

U 

54 

36 

6 

70 

46 

F 

86 

56 

V 
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ERROR 
CODE NO. 


ERROR CODE MESSAGE 


16 RETURN Error: A RETURN was encountered without a matching GOSUB. 

17 Garbage Error: Execution of “garbage” (bad RAM bits) was attempted. This error 
code may indicate a hardware problem, but may also be the result of faulty use of 
POKE. Try typing NEW or powering down, then re-enter the program without 
any POKE commands. 

18 Invalid String Character: String does not Start with a valid character, or string 
in VAL Statement is not a numeric string. 

Note: The following are INPUT/OUTPUT errors that result during the use of disk 

drives, printers, or other accessory devices. Further Information is pro- 
vided with the auxiliary hardware. 

19 LOAD program Too Long: Insufficient memory remains to complete LOAD. 

20 Device Number Larger than 7 or Equal to 0. 

21 LOAD File Error: Attempted to LOAD a non-LOAD file. 

128 BREAK Abort: User hit KETOM key during I/O Operation. 

129 IOCB 1 already open. 

130 Nonexistent Device specified. 

131 IOCB Write Only. READ command to a write-only device (Printer). 

132 Invalid Command: The command is invalid for this device. 

133 Device or File not Open: No OPEN specified for the device. 

134 Bad IOCB Number: Illegal device number. 

135 IOCB Read Only Error: WRITE command to a read-only device. 

136 EOF: End of File read has been reached. {NOTE: This message may occur when 
using cassette files.) 

137 Truncated Record: Attempt to read a record longer than 256 characters. 

138 Device Timeout. Device doesn’t respond. 

139 Device NAK: Garbage at serial port or bad disk drive. 

140 Serial bus input framing error. 

141 Cursor out of ränge for particular mode. 

142 Serial bus data frame overrun. 

'IOCB refers to Input/Output Control Block. The device number is the same as the IOCB number. 
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RESERVED 

WORD: 


ABBRE VIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


PTRIG 


Function returns Status of the trigger button on game 
Controllers. 

PUT 

PU. 

Causes output of a single byte of data from the Computer 
to the specified device. 

RAD 


Specifies that Information is in radians rather than 
degrees when using the trigonometric functions. 
Default is to RAD. (See DEG.) 

READ 

REA. 

Read the next items in the DATA list and assign to 
specified variables. 

REM 

R. or . 

Remarks. This Statement does nothing, but comments 
may be printed within the program list for future 
reference by the programmer. Statements on a line that 
Starts with REM are not executed. 

RESTORE 

RES. 

Allows DATA to be read more than once. 

RETURN 

RET. 

RETURN from subroutine to the Statement immediate- 
ly following the one in which GOSUB appeared. 

RND 


Function returns a random number between 0 and 1, 
but never 1. 

RUN 

RU. 

Execute the program. Sets normal variables to 0, un- 
dims arrays and string. 

SAVE 

S. 

I/O Statement causes data or program to be recorded on 
disk under filespec provided with SAVE. 

SETCOLOR 

SE. 

Store hue and luminance color data in a particular color 
register. 

SGN 


Function returns +1 if value is positive, 0 if zero, - 1 if 
negative. 

SIN 


Function returns trigonometric sine of given value 

(DEG or RAD). 

SOUND 

SO. 

Controls register, sound pitch, distortion, and volume of 
a tone or note. 

SQR 


Function returns the square root of the specified value. 

STATUS 

ST. 

Calls Status routine for specified device. 

STEP 


Used with FOR/NEXT. Determines quality to be 
skipped between each pair of loop variable values. 

STICK 


Function returns position of stick game Controller. 

STRIG 


Function returns 1 if stick trigger button not pressed, 0 
if pressed. 

STOP 

STO. 

Causes execution to stop, but does not close files or turn 
off sounds. 
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RESERVED 

WORD: 


A BBRE VI ATI ON: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


DATA 

D. 

Part of READ/DATA combination. Used to identify the 
succeeding items (which must be separated by commas) 
as individual data items. 

DEG 

DE. 

Statement DEG teils Computer to perform 
trigonometric functions in degrees instead of radians. 
(Default in radians.) 

DIM 

DI. 

Reserves the specified amount of memory for matrix, 
array, or string. All string variables, arrays, matrices 
must be dimensioned with a DIM Statement. 

DOS 

DO. 

Reserved word for disk operators. Causes the menu to 
be displayed. (See DOS Manual.) 

DRAWTO 

DR. 

Draws a straight line between a plotted point and 
specified point. 

END 


Stops program execution; closes files; turns off sounds. 
Program may be restarted using CONT. (Note: END 
may be used more than once in a program.) 

ENTER 

E. 

I/O command used to störe data or programs in un- 
tokenized (source) form. 

EXP 


Function returns e (2.7182818) raised to the specified 
power. 

FOR 

F. 

Used with NEXT to establish FOR/NEXT loops. In- 
troduces the ränge that the loop variable will operate in 
during the execution of loop. 

FRE 


Function returns the amount of remaining user 
memory (in bytes). 

GET 

GE. 

Used mostly with disk operations to input a single byte 
of data. 

GOSUB 

GOS. 

Branch to a subroutine beginning at the specified line 
number. 

GOTO 

G. 

Unconditional branch to a specified line number. 

GRAPHICS 

GR. 

Specifies which of the eight graphics modes is to be 
used. GR.O may be used to clear screen. 

IF 


Used to cause conditional branching or to execute 
another Statement on the same line (only if the first ex- 
pression is true). 

INPUT 

I. 

Causes Computer to ask for input from keyboard. Ex¬ 
ecution continues only when QS3ÜEI3 k- e y is pressed after 
inputting data. 

INT 


Function returns the next lowest whole integer below 
the specified value. Rounding is always downward, 
even when number is negative. 

LEN 


String function returns the length of the specified str¬ 
ing in bytes or characters (1 byte contains 1 character). 
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Now enter the hexadecimal Codes as shown column by column. 



G8 

2 


A2 

E8 


0 

EO 


AC 

3 


C4 

90 


2 

F5 


BD 

8C 


C5 

C7 


2 

2 


9D 

60 


C4 

BYTES = 21 

When completed, type DO NE and press IMhV. Now place the Cursor after the 
last entry (999) on the DATA line and press I3233II- 

Now run the program by typing GOTO 1000 and pressing 1323231 > or if line 5 

has been added, type RUN §32323 • 
5. 

Press stop program and delete line 

The second program, which follows, should be entered in place of the 

NOTHING IS MOVING program. Be sure to check the BYTES = count in 

line 1000. 

Foliow steps 2 through 6. 

1080 

GRAPHICS 7+16 


1090 

SETCOLOR 0.9.4 


1100 

SETCOLOR 1.9.8 


1110 

SETCOLOR 2.9.4 


1120 

CR=1 


1130 

FOR X=0 TO 159 


1140 

COLOR INK CR) 


1150 

PLOT 30.8 


1160 

ORAWTO X.95 


1170 

CR=CR+0.125 


1180 

IF CR=4 THEN CR=1 


1190 

NEXT X 


1200 

X=USR(A0R(E$)+1) 


1210 

FOR 1=1 TO 15 : NEXT 

i 

1220 

GOTO 1200 


Type RUN IJmiJM 


Enter the hexadecimal codes for this program column by column. 


68 

2 


A2 

E8 


0 

E0 


AC 

2 


C4 

90 


2 

F5 


BD 

8C 


C5 

C6 


2 

2 


9D 

60 


C4 ' 

BYTES = 21 
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1. To use this program, first enter it. After entering it, save this program on 
disk or cassette for future use. 


10 GRAPHICS 0=PRINT "HEXCODE LOADER PROG 
RAM"-PRINT 

20 REM STORES DECIMAL EQUIUALEHTS IN ARR 
AY A, OUTPUTS IN PRINTED ‘DATA STATEMENT 
S' AT 

21 REM LINE NUMBER 1508. 

38 REM USER THEN PLACES CURSOR OH PRINTE 
0 OUTPUT LINE, HITS "RETURN", AND ENTERS 

31 REM REST OF BASIC PROGRAM INCLUDING U 
SR STATEMENT. 

40 DIM A(50),HEXf(5) 

50 REM INPUT,CONUERSION,STORAGE OF DATA. 

68 N=0=PRINT "ENTER 1 HEX CODE. IF LAST 
ONE IS IN, ENTER 'DÜNE' 

70 INFUT HEX$ 

80 IF HEX$="DÜNE" THEN N=393=GOTO 130 
98 FOR 1=1 TO LENCHEXI) 

108 IF HEX$< I, IX="9" THEN N=hfölb+UAL(HE 
X$( I, I)> : GOTO 120 

110 N=N# 16+ASCCHEX$ C I, I) >-ASC< "A“ >+10 

120 NEX.T I 

130 FEINT N : C=C+1 

140 A< C >=N 

150 IF N< >939 THEN GOTO 60 

190 REM FEINT OUT DATA LINE AT 1500 

200 GRAPHICS 0:PRINT "1500 DATA"; 

210 C=0 
228 C=C+1 

230 IF ACC>=399 THEN PRINT "939" : STOF' 

240 PRINT AC C >;","; 

250 ACC>=0 
260 GOTO 228 

300 FEINT "PUT CORRECT NUMBER OF HEX BYT 
ES IN LINE 1000,"=STOP : REM TRAP LINE 
999 REM n EXECUTIÖN MODULE U 
1008 CLR : BYTES=0 

1010 TRAP 300 = DIM EK1>,ECINTCBYTES/6>+l 

> 

1030 FOR 1=1 TO BYTES 

1040 READ A=IF A>255 THEN GOTO 1060 

1058 POKE ADRCEl)+I,A 

1060 NEXT I 

1070 REM BASIC PART OF USER'S PROGRAM FO 
LLOWS 


Figure 11-1. Hexcode Loader Input Program 
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If you need to save memory, avoid programs like this: 


10 X=Y+1 
28 Y=Y+1 
30 Z=X+Y 
40 PRINT Z 
50 GOTO 50 


and consolidate lines like this: 

10 X=X+1 : Y=Y+1 : Z=X+Y : PRINT Z=G0T0 10 


This consolidation saves 12 bytes. 


3. Variables and constants should be “managed” for savings, too. Each time a 
constant (4,5,16,3.14159, etc.) is used, it takes 7 bytes. Defining a new 
variable requires 8 bytes plus the length of the variable name (in characters). 
But each time it is used after being defined, it takes only 1 byte, regardless of 
its length. Thus, if a constant (such as 3.14159) is used more than once or 
twice in a program, it should be defined as a variable, and the variable name 
used throughout the program. For example: 


10 PI=3.14159 

20 PRINT "AREA OF A CIRCLE IS THE RADIUS 
SQUhRED TIMES ";PI 


4. Literal strings require 2 bytes overhead and 1 byte for each character 
(including all spaces) in the string. 


5. String variables take 9 bytes each plus the length of the variable name 
(including spaces) plus the space eaten up by the DIM Statement plus the size 
of the string itself (1 byte per character, including spaces) when it is defined. 
Obviously, the use of string variables is very costly in terms of RAM. 


6. Definition of a new matrix requires 15 bytes plus the length of the matrix 
variable name plus the space needed for the DIM Statement plus 6 times the 
size of the matrix (product of the number of rows and the number of col- 
umns). Thus, a 25 row by 4 column matrix would require 15 + approxi- 
mately 3 (for variable name) + approximately 10 (for the DIM Statement) + 6 
times 100 (the matrix size), or about 630 bytes. 
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STRIG 


14 



Format: STRIG(aexp) 

Example: 100 IF STRIG® = 0 THEN PRINT “FIRE TORPEDO” 

The STRIG function works the same way as the PTRIG function. It can be used 
with both the joystick and keyboard Controllers. 
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Using the note values in Table 10-1, the following example demonstrates how to 
write a program that will “play” the C scale. 

TABLE 10.1. TABLE OF PITCH VALUES FOR THE MUSICAL 

NOTES 


HIGH C 29 

NOTES B 31 

A# or Bb 33 

A 35 

G# or Ab 37 

G 40 

F# or Gb 42 

F 45 

E 47 

___D# or E_ _ 50 

D 53 

C# or Db 57 

C 60 

B 64 

A# or B 68 

A 72 

G# or Ab 76 

G 81 

F# or Gb 85 

F 91 

E 96 

D# or Eb 102 

D 108 

C# or Db 114 

MIDDLE C C 121 

B 128 

A# or ßb 136 

A 144 

G# or Ab 153 

G 162 

F# Gb 173 

F 182 

LOW NOTES D 193 

D# or ib 204 

, D 217 

* C# or Db 230 


C 243 

10 REhD A 

20 IF A=25S THEN END 
30 SOUND 0;H,i0,10 
40 FOR U=1 TO 400 : NEKT bi 
50 PRINT A 
60 GOTO 10 
70 END 



Note that the DATA Statement in line 80 ends with a 256, which is outside of the 
designated ränge. The 256 is used as an end-of-data marker. 
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Table 9.7—CHARACTER/COLOR ASSIGNMENT 


Conversion 1 

Conversion Z 

Conversion 3 

Conversion 4 

MODE 0 

2 SETCOLOR 2 

#+32 

# + 32 

#-32 

NONE 


POKE 756,224 

POKE 756,226 

MODE 1 

SETCOLOR 0 

- $ 32 

#+32 

#-32 

#-32 

OR 

SETCOLOR 1 

NONE 

#+64 

#-64 

NONE 

MODE Z 

SETCOLOR 2 

# + 160 

# + 160 

# + 96 

# + 96 


SETCOLOR 3 

#+128 

#+192 

# + 64 

#+128 


2. Luminance controlled by SETCOLOK 1, 0, LUM. 


3. POKE the Character Base Address (CHBAS) with 226 to specify lower case let- 
ters or special graphics characters; e.g., 

POKE 756,226 
or 

CHBAS = 756 
POKE CHBAS, 226 


To return to upper case letters, numbers, and punctuation marks, POKE CHBAS 
with 224. 

4. A PRINT Statement using the converted number (82) assigns the lower case 
“r” to SETCOLOR 0 in mode 2 (see Table 9-5). 

Graphic Control Characters 

These characters are produced when the GQ9 key is pressed with the 
alphabetic keys shown on back cover. These characters can be used to draw 
design, pictures, etc., in mode 0 and in modes 1 and 2 if CHBAS is changed. 
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XIO (X.) 
SPECIAL FILL 
APPLICATION 


Format: XIO 18, #aexp, aexpl, aexp2, filespec 

Example: 100 XIO 18, #6, 0, 0, “S:” 


This special application of the XIO Statement fills an area on the screen between 
plotted points and lines with a non-zero color value. Dummy variables (0) are 
used for aexpl and aexp2. 

The following Steps illustrate the fill process: 


1. PLOT bottom right corner (point 1). 

2. DRAWTO upper right corner (point 2). This outlines the right edge of the 
area to be filled. 

3. DRAWTO upper left corner (point 3). 

4. POSITION Cursor at lower left corner (point 4). 

5. POKE address 765 with the fill color data (1, 2, or 3). 

6. This method is used to fill each horizontal line from top to bottom of the spe- 

cified area. The fill Starts at the left and proceeds across the line to the right 
until it reaches a pixel which contains non-zero data (will wraparound if 
necessary). This means that fill cannot be used to change an area which has 
been filled in with a non-zero value, as the fill will stop. The fill command 
will go into an infinite loop if a fill with zero (0) data is attempted on a line 
which has no non-zero pixels. or SEESESSi can use d to stop the 

fill if this happens. 


The following program creates a shape and fills it with a data (color) of 3. Note 
that the XIO command draws in the lines of the left and bottom of the figure. 


10 

GRAPH 

IICS 5+16 

26 

COLOR 

1 

30 

PLOT 

70; 45 

40 

DRÄUT 

0 50;10 

50 

DRAl-iT 

‘ J ,i i yj 

60 

POS IT 

JüN iö,45 

70 

POKE 

765; 3 

80 

XIO 1 

8;£6;0;8;"$ 

y0 

GOTO 

30 


Figure 9-4. Example “FILL” Program 


Assigning Colors To Characters In Text Modes 1 and 2 

This procedure describes the method of assigning colors to the Atari character 
set. First, look up the character number in Table 9-6. Then, see Table 9-7 to get 
the conversion of that number refiuired to assign a color register to it. 

Example: Assign SETCOLOR 0 to lower case “r” in mode 2 

whose color is determined by register 0. 

1. In Table 9-6, find the column and number for “r” (114-column 4). 

2. Using Table 9-7, locate column 4. Conversion is the character number minus 
32 (114 - 32 = 82). 
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Figure 9-3. Atari Logo Program Execution 


Y-AXIS POINTS (ROWS) 
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X-AXIS POINTS (COLUMNS) 



Note: Doing a PRINT after a LOCATE or GET from the screen may cause the 
data in the pixel which was examined to be modified. To avoid this problem, 
reposition the Cursor and put the data that was read, back into the pixel before 
doing the PRINT. 

SETCOLOR (SE.) Format: SETCOLOR aexpl, aexp2, aexp3 

Example: 100 SETCOLOR 0, 1, 4 

This Statement is used to choose the particular hue and luminance to be stored 
in the specified color register. The parameters of the SETCOLOR Statement are 
defined below: 

aexpl = Color register (0-4 depending on graphics mode) 
aexp2 = Color hue number (0-15. See Table 9-3) 

aexp3 = Color luminance (must be an even number between 0 and 14; the 
higher the number, the brighter the display. 14 is almost pure 
white.) 


TABLE 9.3—THE ATARI HUE (SETCOLOR COMMAND) 
NUMBERS AND COLORS 

COLORS 

SETCOLOR (aexp2) NUMBERS 

GRAY 

0 

LIGHT ORANGE (GOLD) 

1 

ORANGE 

2 

RED-ORANGE 

3 

PINK 

4 

PURPLE-BLUE 

6 

BLUE 

7 

BLUE 

8 

LIGHT BLUE 

9 

TURQUOISE 

10 

GREEN-BLUE 

11 

GREEN 

12 

YELLOW-GREEN 

13 

ORANGE-GREEN 

14 

LIGHT ORANGE 

15 

Note: Colors will vary with type and adjustment of TV or monitor used. 


The ATARI display hardware contains five color registers, numbered 
from 0 through 4. The Operating System (OS) lias five RAM locations (COLORO 
through COLOR4, see Appendix I - Memory Locations) where it keeps track of 
the current colors. The SETCOLOR Statement is used to change the values in 
these RAM locations. (The OS transfers these values to the hardware registers 
every television frame.) The SETCOLOR Statement requires a value from 0 to 4 
to specify a color register. The COLOR Statement uses different numbers 
because it specifies data which only indirectly corresponds to a color register. 
This can be confusing, so careful experimentation and study of the various 
tables in this section is advised. 

No SETCOLOR commands are needed if the default set of five colors is used. 
Although 128 different color-luminance combinations are possible, not more 
than five can be displayed at any one time. The purpose of the color registers 
and SETCOLOR Statement is to specify these five colors. 
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COLOR (C.) 


DRAWTO (DR.) 


LOCATE (LOC.) 


Format: COLOR aexp 

Examples: 110 COLOR ASC(“A”) 

110 COLOR 3 

The value of the expression in the COLOR Statement determines the data to be 
stored in the display memory for all subsequent PLOT and DRAWTO com- 
mands until the next COLOR Statement is executed. The value must be positive 
and is usually an integer from 0 through 255. Non-integers are rounded to the 
nearest integer. The graphics display hardware interprets this data in different 
ways in the different graphics modes. In text modes 0 through 2, the number 
can be from 0 through 255 (8 bits) and determines the character to be displayed 
and its color. (The two most significant bits determine the color. This is why on- 
ly 64 different characters are available in these modes instead of the full 
256-character set.) 

Tables 9-6 and 9-7 at the end of this section illustrate the internal character set 
and the character/color assignment. Table 9-2 is a simplifled table which allows 
easy generation of some of the colors. For example, COLOR ASC(“A”): PLOT 
5,5 will display an orange A character in graphics modes 1 or 2 at location 5,5. 

Graphics modes 3 through 8 are not text modes, so the data stored in the display 
RAM simply determines the color of each pixel. Two-color or two-luminance 
modes require either 0 or 1 (1-bit) and four-color modes require 0,1, 2, or 3. (The 
expression in the COLOR Statement may have a value greater than 3, but only 
one or two bits will be used.) The actual color which is displayed depends on the 
value in the color register which corresponds to the data of 0, 1, 2, or 3 in the 
particular graphics mode being used. This may be determined by looking in 
Table 9-5, which gives the default colors and the corresponding register 
numbers. Colors may be changed by using SETCOLOR. 

Note that when BASIC is first powered up, the color data is 0, and when a 
GRAPHICS command (without +32) is executed, all of the pixels are set to 0. 
Therefore, nothing seems to happen to PLOT and DRAWTO in GRAPHICS 3 
through 7 when no COLOR Statement has been executed. Correct by doing a 
COLOR 1 first. 


Format: DRAWTO aexpl, aexp2 

Example: 100 DRAWTO 10, 8 

This Statement causes a line to be drawn from the last point displayed by a PLOT 
(see PLOT) to t he location specified by aexpl and aexp2. The first expression 
represents the X coordinate and the second represents the Y-coordinate (see 
Figure 9-1). The color of the line is the same color as the point displayed by the 
PLOT. 

Format: LOCATE aexpl, aexp2, var 

Example: 150 LOCATE 12, 15, X 

This command positions the invisible graphics Cursor at the specified location in 
the graphics window, retrieves the data at that pixel, and Stores it in the 
specified arithmetic variable. This gives a number from 0 to 255 for Graphics 
modes 0 through 2; 0 or 1 for the 2-color graphics modes; and 0, 1, 2, or 3 for the 
4-color modes. The two arithmetic expressions specify the X and Y Coordinates 
of the point. LOCATE is equivalent to: 

POSITION aexpl, aexp2:GET #6,avar 
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GRAPHICS 
MODE 0 


GRAPHICS 
MODES 
1 AND 2 


This mode is the 1-color, 2-luminance (brightness) default mode for the ATARI 
Personal Computer. It contains a 24 by 40 character screen matrix. The default 
margin settings at 2 and 39 allow 38 characters per line. Margins may be chang- 
ed by poking LMARGN and RMARGN (82 and 83). See Appendix I. Some Systems 
have different margin default settings. The color of the characters is determined 
by the background color. Onlv the luminance of the characters can be different. 
This full-screen display has a blue display area bordered in black (unless the 
border is specified to be another color). To display characters at a specified loca- 
tion, use one of the following two methods. 


Method 1. 

lineno POSITION aexpl, aexp2 
lineno PRINT sexp 

Method 2 

lineno GR. 0 
lineno POKE 752,1 
lineno COLOR ASC(sexp) 

lineno PLOT aexpl,aexp2 

lineno GOTO lineno 


Puts Cursor at location 
specified by aexpl and aexpZ. 

Specfies graphics mode. 
Suppresses Cursor. 

Specfies character to be 
printed. 

Specfies where to print 
character. 

Start loop to prevent READY 
from being printed. (GOTO 
same lineno.) 


Press 

loop. 


BREAK 


to terminate 


GRAPHICS 0 is also used as a clear screen command either in Direct mode or 
Deferred mode. It terminates any previously selected graphics mode and 
returns the screen to the default mode (GRAPHICS 0). 


As defined in Table 9-1, these two 5-color modes are Text modes. However, they 
are both split-screen (see Figure 9-1) modes. Characters printed in Graphics 
mode 1 are twice the width of those printed in Graphics 0, but are the same 
height. Characters printed in Graphics mode 2 are twice the width and height 
of those in Graphics mode 0. In the split-screen mode, a PRINT command is used 
to display characters in either the text window or the graphics window. To 
print characters in the graphics window, specify device #6 after the PRINT com¬ 
mand. 

Example: 100 GR. 1 

110 PRINT^6;“ATARI” 

The default colors depend on the type of character input. Table 9-2 defines the 
default color and color register used for each type. 


Table 9-2. Default Colors for Specific Input Types 

Character Type Color Register Default Color 


Upper case alphabetical 0 

Lower case alphabetical 1 

Inverse upper case alphabetical 2 

Inverse lower case alphabetical 3 

Numbers 0 

Inverse numbers 2 


Orange 
Light Green 
Dark Blue 
Red 

Orange 
Dark Blue 


Note: See SETCOLOR to change character colors. 
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A DIM Statement is used to reserve a certain number of locations in memory for 
a string, array, or matrix. A character in a string takes one byte in memory and 
a number in an array takes six bytes. The first example reserves 101 locations 
for an array designated A. The second example reserves 7 rows by 4 columns 
for a two-dimensional array (matrix) designated M. The third example reserves 
20 bytes designated B$. All strings, arrays, and matrices must be dimen- 
sioned. It is a good habit to put all DIM Statements at the beginning of the pro¬ 
gram. Notice in Figure 8-1 that although the array is dimensioned as DIM A(6), 
there are actually 7 elements in the array because of the 0 element. Although 
Figure 8-2 is dimensioned as DIM M(6,3), 28 locations are reserved. 


Note: The ATARI Personal Computer does not automatically initialize array or 
matrix variables to 0 at the start of program execution. To initialize array or 
matrix elements to 0, use the following program Steps: 


250 DI fl AC 180 
308 FOR E=8 TO 108 
318 h( 3 >=8 
328 HEXT E 


Arrays and matrices are “filled” with data by using FOR/NEXT Statements, 
READ/DATA Statements and INPUT commands. Figure 8-3 illustrates the 
“building” of part of an array using the FOR/NEXT loop and Figure 8-4 builds an 
array using the READ/DATA Statements. 


10 DIM A< 180 > 

28 X-10 

38 FOR £=1 TO 90 
48 H=K+1 
58 h(E)=X 
68 HEXT E 
7o FÜR E=1 TO y8 
80 PRINT E,h<E) 
98 HEXT E 


Figure 8-3. Use of FOR/NEXT to Build An Array 


10 Dlfl A<3> 

20 FOR E=1 TO 3 
30 READ X 


40 h(E)=X 
50 F’RIWT A(E>, 
68 HEXT E 
78 EHD 

188 DATA 33,45; 


12 


Figure 8-4. Use of READ/DATA to Build An Array 



String Comparisons and Sorts 

In string comparisons, the logical operators are used exactly the way they are 
with numbers. The second program in Appendix H is a simple example ofbub- 
ble sort. 

In using logical operators, remember that each letter, number, and symbol is 
assigned an ATASCII code number. A few general rules apply to these codes: 

1. ATASCII codes for numbers are sized in order of the numbers’ real 
values and are always lower than the codes for letters (see Appendix C). 

2. Upper case letters have lower numerical values than the lower case let¬ 
ters. To obtain the ATASCII code for a lower case letter if you know the 
upper case value, add 32 to the upper case code. 


Note: Atari BASIC’s memory management System moves strings around in 
memory to make room for new Statements. This causes the string address to 
vary if a program is modified or Direct mode is used. 



LEN 


STR$ 


VAL 


10 FÜR 1=0 TO 25 

26 PRINT CHRft hSC("A")+I),CHR f< hSC( 

I) 

38 HEXT I 


'V>+ 


Figure 7-2. ASC and CHR$ Program Example 
Note: There can be only one STR$ and only one CHR$ in a logical comparison. 

Format: LEN (sexp) 

Example: 100 PRINT LEN(A$) 

This function returns the length in bytes of the designated string. This informa- 
tion may then be printed or used later in a program. The length of a String 
variable is simply the index for the character which is currently at the end of 
the string. Strings have a length of 0 until characters have been stored in them. 
It is possible to störe into the middle of the string by using subscripting. 
However, the beginning of the string will contain garbage unless something 
was stored (using STO) there previously. 

The following routine illustrates one use of the LEN function: 

10 Din m.m 
28 Af="ATARI" 

30 PRINT LEN(A$> 

Figure 7-3. LEN Function Example 

The result of running the above program would be 5. 


Format: STR$ (aexp) 

Example: A$ = STR$(65) 

This string from number function returns the string form of the number in 
parentheses. The above example would return the actual number 65, but it 
would be recognized by the Computer as a string. 

Note: There can only be one STR$ and only one CHR$ in a logical comparison. 
For example, A = STR$(1) > STR$(2) is not valid and will not work correctly. 

Format: VAL(sexp) 

Example: 100 A = VAL(A$) 

This function returns a number of the same value as the number stored as a 
string. This is the opposite ofa STR$ function. Using this function, the Computer 
can perform arithmetic operations on strings as shown in the following exam¬ 
ple program: 

10 DIU Bf <5 > 

20 Bf="10000" 

30 B=SÜR< UhLa Bf > > 

40 PRINT "THE SQUARE RÜGT OF ";Bf.;" IS " 


Figure 7-4. VAL Function Program 
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USR 


Although this is not a function, it is included in this section because it is closely 
associated with the PEEK function. This POKE command inserts data into the 
memory location or modifies data already stored there. In the above format, 
aexpl is the decimal address of the location to be poked and aexp2 is the data to 
be poked. Note that this number is a decimal number between 0 and 255. POKE 
cannot be used to alter ROM locations. In gaining familiarity with this command 
it is advisable to look at the memory location with a PEEK and write down the 
contents of the location. Then, if the POKE doesn’t work as anticipated, the 
original contents can be poked into the location. 

The above Direct mode example changes the left screen margin from its default 
Position of 2 to a new position of 10. In other words, the new margin will be 8 
spaces to the right. To restore the margin to its normal default position, press 


SYSTEM RESET 


Format: USR (aexpl [, aexp2][, aexp3...]) 

Example: 100 RESULT = USR (ADD1,A*2) 

This function returns the results of a machine-language subroutine. The first ex- 
pression, aexpl, must be an integer or arithmetic expression that evaluates to an 
integer that represents the decimal memory address of the machine language 
routine to be performed. The input arguments aexp2, aexp3, etc., are optional. 
These should be arithmetic expressions within a decimal ränge of 0 through 
65535. A non-integer value may be used; however, it will be rounded to the 
nearest integer. 

These values will be converted from BASIC’s Binary Coded Decimal (BCD) 
floating point number format to a two-byte binary number, then pushed onto 
the hardware stack, composed of a group of RAM memory locations under 
direct control of the 6502 microprocessor chip. Figure 6-1 illustrates the struc- 
ture of the hardware stack. 

N (Number of arguments on the stack-may be 0) 

Xj (High byte of argument X) 

X 2 (Low byte of argument X) 

Yj (High byte of argument Y) 

Y z (Low byte of argument Y) 

Z-, (High byte of argument Z) 

Z 2 (Low byte of argument Z) 


R 1 (Low byte of return address) 

R 2 (High byte of return address) 

Figure 6-1. Hardware Stack Definition 

Note: X is the argument following the address of the routine, Y is the 
second, Z is the third, etc. There are N pairs of bytes. 


See Section 11 for a description of the USR function in machine language pro- 
gramming. Appendix D defines the bytes in RAM available for machine 
language programming. 
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Returns the greatest integer less than or equal to the value of the expression. 
This is true whether the expression evaluates to a positive or negative number. 
Thus, in our first example above, I is used to störe the number 3. In the second 
example, X is used to störe the number - 15 (the first whole number that is less 
than or equal to -14.66778). This INT function should not be confused with the 
function used on calculators that simply truncates (cuts off) all decimal places. 

LOG Format: LOG(aexp) 

Example: 100 L = LOG(67.89/2.57) 

Returns the natural logarithm of the number or expression in parentheses. 
LOG(O) should give an error and LOG(l) should be 0. 

RND Format: RND(aexp) 

Example: 10 A = RND (0) 

Returns a hardware-generated random number between 0 and 1, but never 
returns 1. The variable or expression in parentheses following RND is a dummy 
and has no effect on the numbers returned. However, the dummy variable must 
be used. Generally, the RND function is used in combination with other BASIC 
Statements or functions to return a number for games, decision making, and the 
like. Here’s a simple routine that returns a random number between 0 and 999. 


10 X=RNDi 8 ) (0 is dummy variable) 

20 RX=IHT(1000+X) 

38 PRINT RX 


Format: SGN(aexp) 

Example: 100 X = SGN(-199) (-1 would be returned) 

Returns a -1 if aexp evaluates to a negative number; a 0 if aexp evaluates to 0, or a 
1 if aexp evaluates to a positive number. 

Format: SQR(aexp) 

Example: 100 PRINT SQR(100) (10 would be printed) 

Returns the square root of the aexp which must be positive. 


TRIGONOMETRIC 

FUNCTIONS 


ATN Format: ATN(aexp) 

Example: 100 X = ATN(65) 

Returns the arctangent of the variable or expression in parentheses. 

COS Format: COS(aexp) 

Example: 100 C = COS(X + Y + Z) 

Note: Presumes X, Y, Z previously defined! 

Returns the trigonometric cosine of the expression in parentheses. 
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and lines with a color (see Section 9). The parameters for this command are de- 
fined as follows: 

cmdno Number that Stands for the particular command to 

be performed. 


cmdno 

OPERATION 

EXAMPLE 

3 

OPEN 

Same as BASIC OPEN 

5 

GET RECORD 

These 4 commands are similar to 

7 

GET CHARACTERS 

BASIC INPUT GET, PRINT, and PUT 

9 

PUT RECORD 


11 

PUT CHARACTERS 

respectively. 

12 

CLOSE 

Same as BASIC CLOSE 

13 

STATUS REQUEST 

Same as BASIC STATUS 

17 

DRAW LINE 

Same as BASIC DRAWTO 

18 

FILL 

See Section 9 

32 

RENA ME 

XIO 32,#1,0,0,“D:TEMP.CAROL” 

33 

DELETE 

XIO 33,#1,0,0,“D:TEMP.BAS” 

35 

LOCK FILE 

XIO 35,#1,0,0,“D:TEMP.BAS” 

36 

UNLOCK FILE 

XIO 36,#1,0,0,“D:TEMP.BAS” 

37 

POINT 

Same as BASIC POINT 

38 

NOTE 

Same as BASIC NOTE 

254 

FORMAT 

XIO 254,#1,0,0,“D2:” 


aexp Device number (same as in OPEN). Most of the time 

it is ignored, but must be preceded by tt. 

aexpl Two auxiliary control bytes. Their usage 

aexp2 depends on the particular device and command. In 

most cases, they are unused and are set to 0. 

filespec String expression that specifies the device. Must be 
enclosed in Quotation marks. Although some com- 
mands, like Fill (Section 9), do not look at the 
filespec, it must still be included in the Statement. 


CHAINING 

PROGRAMS 


If a program requires more memory than is available, use the following steps to 
string programs of less than the maximum memory available into one program. 


1 . 

2 . 

3. 


4. 

5. 

6 . 

7. 

8 . 

9. 


Type in the first part of the program in the normal way. 

The last line of the first part of the. program should contain only the line 
number and the command RUN“C:” 

Cue the tape to the blank section. Write down the program counter number 
for later RUN purposes. Press PLAY and RECORD buttons on the deck so that 
both remain down. 

Type SAVE“C:” and press E5BESI • 

When the beeping sound occurs, press ESEJI again. 

When the screen displays “READY”, do not move tape. Type NEW GSEEEl. 
Repeat the above instructions for the second part of the program. 

As the second part of the program is essentially a totally neW program, it is 
possible to re-use the line numbers used in the first part of the program. 
If there is a third part of the program, make sure the last line of the second 
part is a RUN“C:” command. 
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POINT (P.) 


PRINT (PR or ?) 


PUT(PU.)/ 

GET(GE.) 


READ (REA.) 
DATA (D.) 


Format: POINT #aexp, avar, avar 

Example: 100 POINT #2, A,B 

This command is used when reading a file into RAM. The first avar specifies the 
sector number and the second avar specifies the byte within that sector where 
the next byte willbe read or written. Essentially, it moves a software-controlled 
pointer to the specified location in the file. This gives the user “random” access 
to the data stored on a disk file. The POINT and NOTE commands are discussed 
in more detail in the DOS Manual. 

Format: PRINT [#aexp] j ’ ] [exp] [,exp...] 

Examples: PRINT X, Y, Z, A$ 

100 PRINT “THE VALUE.OF X IS ”;X 

100 PRINT “COMMAS”, “CAUSE”, “COLUMN”, “SPACING” 

100 PRINT #3. A$ 


A PRINT command can be used in either Direct or Deferred mode. In Direct 
mode, this command prints whatever information is contained between the 
quotation marks exactly as it appears. In the first example, PRINT X,Y,Z,A$, the 
screen will display the current values of X,Y,Z, and A$ as they appear in the 
RAM-resident program. In the last example, PRINT #3,A$, the #3 is the file 
specifier (may be any number between 1 and 7) that Controls to which device 
the value of A$ will be printed. (See Input/Output Devices.) 


A comma causes tabbing to the next tab location. Several commas in a row cause 
several tab jumps. A semicolon causes the next aexp or sexp to be placed im- 
mediately after the preceding expression with no spacing. Therefore, in the 
second example a space is placed before the ending quotation mark so the value 
of X will not be placed immediately after the word “IS”. If no comma or 
semicolon is used at the end of a PRINT Statement, then a E5ESSI is output and 
the next PRINT will Start on the following line. 


Format: PUT #aexp, aexp 

GET #aexp, 

Examples: 100 PUT #6, ASC(“A”) 
200 GET n,X 


The PUT and GET are opposites. The PUT command .Outputs a single byte from 
0-255 to the file specified by #aexp. is a mandatory character in both these 
commands). The GET command reads one byte from 0-255 (using #aexp to 
designate the file, etc. on diskette or elsewhere) and then Stores the byte in the 
variable avar. 


Formats: READ var [ , var...] 

DATA adata [ , adata...] 

Examples: 100 READ A,B,C,D,E 

110 DATA 12,13,14,15,16 
100 READ A$,B$,C$,D$,E$ 

110 DATA EMBEE, EVELYN, CARLA, CORINNE, BARBARA 


These two commands are always used together and the DATA Statement is 
always used in Deferred mode 1 . The DATA Statement can be located anywhere 

1 A Direct mode READ will only read data if a DATA Statement was executed in the program. 
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LOAD (LO.) 


LPRINT (LP.) 


NOTE (NO.) 


OPEN (O.) 
CLOSE (CL.) 


Format: LOAD filespec 

Example: LOAD “D1JANINE.BRY” 

This command is similar to CLOAD except the full file name System can be used. 
LOAD uses long inter-record gaps on the tape (see CLOAD) and uses the token- 
ized version of the program. When using only one disk drive, it is not necessary 
to specify a number after the “D” because the default is disk drive tt\. 


Format: LPRINT [exp]|_ { ^ j exp...J 

Example: LPRINT “PROGRAM TO CALCULATE X” 
100 LPRINT X;“ ”;Y;“ ”;Z 


This Statement causes the Computer to print data on the line printer rather than 
on the screen. It can be used in either Direct or Deferred modes. It requires no 
device specifier and no OPEN or CLOSE Statement. (BASIC uses IOCB #7.) 


The above program listing illustrates a program that will add 5 numbers 
entered by the user. To print a program listing on the line printer, see LIST. 


Format: NOTE #aexp, avar, avar 

Example: 100 NOTE #1, X, Y 

This command is used to störe the current disk sector number in the first avar 
and the current byte number within the sector in the second avar. This is the 
current read or write position in the specified file where the next byte to be 
read or written is located. This NOTE command is used when writing data to a 
disk file (see POINT). The Information in the NOTE command is written into a 
second file which is then used as an index into the first file. 


Formats: OPEN #aexp,aexpl,aexp2, filespec 

CLOSE #aexp 

Examples: 100 OPEN #2,8,0,“D1:ATARI800.BAS” 

100 A$ = “D1:ATARI800.BAS” 

110 OPEN #2,8,0,A$ 

150 CLOSE #2 

Before a device can be accessed, it must be opened. This “opening” process links 
a specific IOCB to the appropriate device handler, initializes anv ClO-related Con¬ 
trol variables, and passes any device-specific options to the device handler. The 
Parameters for the OPEN command are defined as follows: 

# Mandatory character that must be entered by the 

user. 

aexp Reference IOCB or file number to same parameters 

for future use (as in CLOSE command). Number 
may be 1 through 7. 
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CLOAD (CLOA.) 


CSAVE (CS.) 


Disk Drives: (Dl:, D2:, D3:, D4:) Input and Output devices. If 16K of RAM is 
installed, the ATARI can use from one to four disk drives. If only one disk drive 
is attached, there is no need to add a number after the symbolic device code D. 


Screen Editor: (E:) Input and Output device. This device uses the keyboard 
and display (see TV Monitor ) to simulate a screen editing terminal. Writing to 
this device causes data to appear on the display starting at the current Cursor 
Position. Reading from this device activates the screen editing process and 
allows the user to enter and edit data. Whenever the E2EQ9 key is pressed, the 
entire logical line within which the Cursor resides is selected as the current 
record to be transferred by CIO to the user program. (See Section 9). 


TV Monitor: (S:) Input and Output device. This device allows the user to read 
characters from and write characters to the display, using the Cursor as the 
screen addressing mechanism. Both text and graphics operations are supported. 
See Section 9 for a complete description of the graphics modes. 

Interface, RS-232: (R:) The RS-232 device enables the ATARI System to inter- 
face with RS-232-compatible devices such as printers, terminals, and plotters. It 
contains a parallel port to which the 80-column printer (ATARI 825™) can be at¬ 
tached. 


Format: CLOAD 

Examples: CLOAD 

100 CLOAD 


This command can be used in either Direct or Deferred mode to load a program 
from cassette tape into RAM for execution. On entering CLOAD, one bell rings 
to indicate that the PLAY button needs to be pressed followed by B3D3Ü . 
However, do not press PLAY until after the tape has been positioned. Specific in- 
structions for CLOADing a program are contained in the ATARI 410 Program 
Recorder Manual. Steps for loading oversized programs are included in the 
paragraphs under CHAINING PROGRAMS at the end of this section. 


Format: CSAVE 

Examples: CSAVE 

100 CSAVE 
100 CS. 


This command is usually used in Direct mode to save a RAM-resident program 
onto cassette tape. CSAVE saves the tokenized Version of the program. On enter¬ 
ing CSAVE two bells ring to indicate that the PLAY and RECORD buttons must 
be pressed followed by l:l=WH:l!l . Do not, however, press these buttons until the 
tape has been positioned. It is faster to save a program using this command 
rather than a SAVE “C” (see SAVE) because short inter-record gaps are used. 


Notes: Tapes saved using the two commands, SAVE and CSAVE, are not com- 
patible 


It may be necessary to enter an LPRINT (see LPRINT) before using 
CSAVE. Otherwise, CSAVE may not work properly. 

For specific instructions on how to connect and operate the hardware, 
cue the tape, etc., see the ATARI 410 Program Recorder Manual. 
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TRAP (T.) 


and B, because of the RESTORE Statement, will still equal 30. Therefore, the 
PRINT Statement in line 50 will display SUM TOTAL EQUALS 45. 


Format: TRAP aexp 

Example: 100 TRAP 120 

The TRAP Statement is used to direct the program to a specified line number if 
an error is detected. Without a TRAP Statement, the program stops executing 
when an error is encountered and displays an error message on the screen. 

The TRAP Statement works on any error that may occur after it has been ex- 
ecuted, but once an error has been detected and trapped, it is necessary to reset 
the trap with another TRAP command. This TRAP command may be placed at 
the beginning of the section of code that handles input from the keyboard so 
that the TRAP is reset after each error. PEEK(195) will give you an error 
message (see Appendix B). 256* PEEK(187) + PEEKC18G) will give you the number 
of the line where the error occurred. The TRAP may be cleared by executing a 
TRAP Statement with an aexp whose value is from 32767 to 65535 (e.g., 40000). 
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ON/GOSUB/ 

RETURN 

ON/GOTO 


POP 


Format: ON aexp I GOTO) lineno [ ,lineno...] 

IgosubJ 

Exainples: 100 ON X GOTO 200, 300, 400 
100 ON A GOSUB 1000, 2000 
100 ON SQR(X) GOTO 30, 10, 100 

Note: GOSUB and GOTO may not be abbreviated. 

These two Statements are also conditional branch Statements like the IF/THEN 
Statement. However, these two are more powerful. The aexp must evaluate to a 
positive number which is then rounded to the nearest positive integer (whole 
number) value up to 255. If the resulting number is 1, then program control 
passes to the first lineno in the list following the GOSUB or GOTO. If the 
resulting number is 2, program control passes to the second lineno in the list, 
and so on. If the resulting number is 0 or is greater than the number of linenos 
in the list, the conditions are not met and program control passes to the next 
Statement which may or may not be located on the same line. With ON/GOSUB, 
the selected subroutine is executed and then control passes to the next State¬ 
ment. 

The following routine demonstrates the ON/GOTO Statement: 


10 x=x+i 

20 0N X GOTO 100.-200,390,490.508 
30 IF X>5 THEN PRINT "CGMPLETE." : END 
40 GOTO 10 
50 ENO 

180 PRINT "NOM WORKING RT LINE 188" ; GOTO 
10 

208 PRINT "MÜL WORKING RT LINE 208" : GOTO 
10 

308 PRINT "NON WORKING RT LINE 300”=GOTO 
18 

488 PRINT "N0W WORKING RT LINE 408"=GOTO 
10 

508 PRINT "NON WORKING RT LINE 588"•GOTO 
18 


Figure 4-9 ON/GOTO Program Listing 


When 

the program is executed, it looks like the following: 

NOW 

WORKING 

RT 

LINE 

108 

NON 

WORKING 

RT 

LINE 

288 

NOW 

WORKING 

RT 

LINE 

388 

NOW 

WORKING 

RT 

LINE 

480 

NON 

WORKING 

RT 

LINE 

588 

COMF 

TETE. 





Figure 4-10 ON/GOTO Program Execution 

Forma t: POP _ 

Example: 1000 POP 
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10 PRINT 

20 PRINT :PRINT "ONE“ 
30 PRINT "TWO" 

40 PRINT "THF:EE" 

50 PRINT 'TOUR'' 

60 PRINT "FINE" 

65 GOTO 100 
70 print 

88 PRIN 


*1 I 


l! VVVV VW V V WWW ** 


90 PRINT 
95 END 

100 PRINT ”3IN" 
118 PRINT "SEUEN" 
120 PRINT "EIGHT" 


130 PRINT 
140 PRINT 
150 GL 


”NINE ,! 

iiTri i tt 

ihn 

70 


Figure 4-5. GOTO Program Listing 

Upon execution, the numbers in the above listing will be listed first followed by 
the three rows of Symbols. The Symbols listed on lines 70, 80, and 90 are ignored 
temporarily while the program executes the GOTO 100 command. It proceeds 
with the printing of the numbers “SIX” through “TEN”, then executes the se- 
cond GOTO Statement which transfers program control back to line 70. (This is 
just an example. This program could be rewritten so that no GOTO Statements 
were used.) The program, when executed, looks like the following: 


Oft 

TWO 

THREE 

F0UR 

FIUE 

SIX 

SEUEN 

EIGHT 

MINE 

TEN 


IF/THEN 


Figure 4-6. GOTO Program Run 

Format: IF aexp THEN f lineno 1 

( Statement [:statement...] J 
Examples: IF X = 100 THEN 150 

IF A$ = “ATARI” THEN 200 

IF AA = 145 and BB = 1 THEN PRINT AA, BB 

IF X = 100 THEN X = 0 
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In Figure 4-1, the outer loop will complete three passes (X = 1 to 3 ). However, 
bcfore this first loop reaches its NEXT X Statement, the program gives control to 
the inner loop. Note that the NEXT Statement for the inner loop must precede 
the NEXT Statement for the outer loop. In the example, the inner loop’s number 
of passes is determined by the STEP Statement (STEP Z). In this case, Z has 
been defined as 0, then redefined as Z + 2. Using this data, the Computer must 
complete three passes through the inner loop before returning to the outer loop. 
The aexp3 in the Step Statement could also have been defined as the numerical 
value 2. 

The program run is illustrated in Figure 4-2. 


GUTER LOOP 
INNER LOOP 
INNER LOOP 
INNER LOOP 
OUTER LOOP 
INNER LOOP 
INNER LOOP 
INNER LOOP 
OUTER LOOP 
INNER LüüP 
INNER LOOP 
INNER LOOP 


Figure 4-2. Nested. Loop Execution 

The return address for the loops are placed in a special group of memory ad- 
dresses referred to as a stack. The Information is “pushed” on the stack and 
when used, the Information is “popped” off the stack (see POP.) 


GOSUB (GOS.) 
RETURN (RET.) 


Format: GOSUB lineno 

lineno 
RETURN 

Example: 100 GOSUB 2000 

2000 PRINT “SUBROUTINE” 
2010 RETURN 


A subroutine* is a program or routine used to compute a certain value, etc. It is 
generally used when an Operation must be replaced several times within a pro¬ 
gram sequence using the same or different values. This command allows the 
user to “call” the subroutine 1 , if necessary. The last line of the subroutine must 
contain a RETURN statement. The RETURN Statement goes back to the physical 
line following the GOSUB statement. 

Like the preceding FOR/NEXT command, the GOSUB/RETURN command 
uses a stack for its return address. If the subroutine is not allowed to complete 
normally; e.g., a GOTO lineno before a RETURN, the GOSUB address must be 
“popped” off the stack (see POP) or it could cause future errors. 


* Generally, a subroutine can do anything that can be done in a program. It is used to save memory 
and program-entering time, and to make programs easier to read and debug. 
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DOUBLE-KEY 

FUNCTIONS 


with other keys to insert and delete lines, return to a 
normal, upper case letter display, and to display the 
function Symbols above the subtraction, ecjuals, addi- 
tion, and multiplication operators as well as the 
brackets, [ ], and question mark,?. 

Cursor Control Keys 

B^S Q Moves Cursor up one physical line without changing 

the program or display. 

BQ9 O Moves Cursor one space to the right without disturb- 

ing the program or display. 

□ Moves Cursor down one physical line without chang¬ 

ing the program or display. 

Q Moves Cursor one space to the left without disturbing 

the program or display. 

Like the other keys on the Atari keyboard, holding the Cursor control keys for 
more than Vz second causes the keys to repeat. 

Keys Used With Eü 

BEB mjjjäilfl Inserts one character space. 

BEB QHÜ23 Deletes one character or space. 

rmi l Stops temporarily and restarts screen display 

without “breaking out” of the program. 

2 Rings buzzer. 

BEB 3 Indicates end-of-file. 

Keys Used With MSTBM 

BJ2E3 Inserts one physical line. 

Deletes one physical line. 

MiliaM IE2-EEEB Returns screen display to upper-case alphabetic 

characters. 

Special Function Keys 

Stops program execution or program list, prints a 
READY on the screen, and displays Cursor. 

UÜS9 Allows commands normally used in Direct mode to 

be placed in Deferred mode; e.g., In Direct mode, 
BEB clears the screen display. To clear the 

screen in Deferred mode, type the following after the 
program line number. Press then press G^B 

and ESU together. 

PRINT “ UM BEB UÜU ” 
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LET (LE.) 


LIST (L.) 


NEW 


REM (R. 


SPACE 


Format: [LET] var = exp 

Example: LET X = 3.142 * 16 

LET X = 2 

This Statement is optional in defining variables. It can just as easily be left out of 
the Statement. It may be used, however, to set a variable name equal to a value. 

Format: LIST [lineno [, lineno] ] 

LIST [filespec [,lineno [,lineno] ] ] 

Examples: 


LIST 


LIST 

10 

LIST, 

10,100 

LIST 

"P. ",20,108 

LIST 

IlpH 

LIST 

"D : DEMO.LST 


This command causes the Computer to display the source Version of all lines cur- 
rently in memory if the command is entered without line number(s), or to 
display a specified line or lines. For example, LIST 10,100 QS233 displays lines 
10 through 100 on the screen. If the user has not typed the lines into the Com¬ 
puter in numerical Order, a LIST will automatically place them in order. 


Typing L.“P will print the RAM-resident program on the printer. 

LIST can be used in Deferred mode as part of an error trapping routine (See 
TRAP in Section 4). 

The LIST command is also used in recording programs on cassette tape. The sec- 
ond format is used and a filespec is entered. (See Section 5 for more details on 
peripheral devices.) If the entire program is to be listed on tape, no line numbers 
need be specified. 

Example: LIST “CI” 

1000 LIST “CI” 


Format: NEW 

Example: NEW 

This command erases the program stored in RAM. Therefore, before typing 
NEW, either SAVE or CSAVE any programs to be recovered and used later. 
NEW clears BASIC’s internal Symbol table so that no arrays (See Section 8) or 
strings (See Section 7) are defxned. Used in Direct mode. 


OF Format: REM text 

) Example: 10 REM ROUTINE TO CALCULATE X 

This command and the text following it are for the user’s information only. It is 
ignored by the Computer. However, it is included in a LIST along with the other 
numbered lines. Any Statement on the same numbered line which occurs after a 
REM Statement will be ignored. 
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BUILT-IN 

FUNCTIONS 


GRAPHICS 


SOUND AND 
GAMES 

CONTROLLERS 


WRAPAROUND 
AND KEYBOARD 
ROLLOVER 


ERROR 

MESSAGES 


The section titled FUNCTION LIBRARY explains the arithmetic and special 
functions incorporated into Atari BASIC. 


Atari graphics include 9 graphics modes. The commands have been designed 
to allow maximum flexibility in color choice and pattern variety. Section 9 ex¬ 
plains each command and gives examples of the many ways to use each. 


The Atari Personal Computer is capable of emitting a large variety of sounds > 
including simulated explosions, electronic music, and “raspberries.” Section 10 
defines the commands for using the SOUND function and for Controlling pad¬ 
dle, Joystick, and keyboard Controllers. 


The ATARI Personal Computer System has screen wraparound thus allowing 
greater flexibility. It also allows the user to type one key ahead. If the user 
presses and holds any key, it will begin repeating alter Vz second. 


If a data entry error is made, the screen display shows the line reprinted preced- 
ed by the message ERROR- and the offending character is highlighted. After 
correcting the character in the original line, delete the line containing the 
ERROR- before pressing . Appendix B contains a list of all the error 

messages and their definitions. 
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BREAK 


ARITHMETIC 

OPERATORS 


LOGICAL 

OPERATORS 


Break key: Pressing this key during program execution causes 
execution to stop. Execution may be resumed by typing CONT 
followed by pressing EäZESI • 


SYSTEM RESET 


System Reset key: Similar to EH33 in that pressing this key 
stops program execution. Also returns the screen display to 
Graphics mode 0, clears the screen, and returns margins and 
other variables to their default values. 


SETCLR-TAB 


Tab key: Press «naM and theBSEEStallkeys simultaneously to 
set a tab. To clear a tab, press the G2Ü9 an d dZÜESQÜ keys 
simultaneously. Used alone, the MafririJEB advances the Cursor to 
the next tab position. In Deferred mode, set and clear tabs by 
preceding the above with a line number, the command PRINT, a 
quotation mark, and press the■äia key. 


DELETE BACK S 


Examples: 

100 PRINT “ 

200 print “ mza rrnrn | 

Default tab settings are placed at columns 7, 15, 23, 31, and 39. 


SHIFT I SET-CLR-TAB 


SET-CLR-TAB 


Insert key: Press the and (EHH3 keys simultaneously to 

insert a line. To insert a single character, press the Q£9 and 
IQSÜS keys simultaneously. 

Delete key: Press the «aiifc and W3I5U keys simultaneously 
to delete a line. To delete a single character, press QJ3 and 
simultaneously. 


DELETE BACK S 


Back Space key: Pressing this key replaces the character to the 
left of the Cursor with a space and moves Cursor back one space. 


Clear key: Pressing this key while holding down the 

key blanks the screen and puts the Cursor in the upper left 
corner. 


SHIFT 


RETURN 


Return key: Terminator to indicate and end of a line of BASIC. 
Pressing this key causes a numbered line to be interpreted and 
added to a BASIC program RAM. An unnumbered line (in Direct 
mode) is interpreted and executed immediately. Any variables 
are placed in a variable table. 


The Atari Personal Computer System uses five arithmetic operators: 

+ addition (also unary plus; e.g., + 5) 

- subtraction (also unary minus; e.g., - 5) 

* multiplication 
/ division 
A exponentiation 


The logical operators consists of two types: unary and binary. The unary 
operator is NOT. The binary operators are: 
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Items in Brackets: Brackets, [ ], contain optional items which may be used, 
but are not required. If the item enclosed in brackets is followed by three dots 
[exp,...], it means that any number of expressions may be entered, but none are 
required. 

Items stacked vertically in braces: Items stacked vertically in braces indicate 
that any one of the stacked items may be used, but that only one at a time is per- 
missible. In the example below, type either the GOTO or the GOSUB. 


100 


(GOTO I 
\ GOSUB) 


2000 


Command abbreviations in headings: If a command or Statement has an ab- 
breviation associated with it, the abbreviation is placed following the full name 
of the command in the heading; e.g., LET (L.). 


ABBREVIATIONS The following table explains the abbreviations used throughout this manual: 


USED IN THIS 
MANUAL 


TABLE 1.1 ABBREVIATIONS 


avar Arithmetic Variable: A location where a numeric value is 

stored. Variable names may be from 1 to 120 alphanumeric 
characters, but must Start with an alphabetic character, and all 
alpha characters must be unreversed and upper case. 


svar String Variable: A location where a string of characters may be 

stored. The same name rules as avar apply, except that the last 
character in the variable name must be a $. String variables may 
be subscripted. See Section 7, STRINGS. 


mvar Matrix Variable: Also called a Subscripted Variable. An ele- 

ment of an array or matrix. The variable name for the array or 
matrix as a whole may be any legal variable name such as A, X, 
Y, ZIP, or K. The subscripted variable (name for the particular 
element) Starts with the matrix variable, and then uses a number, 
variable, or expression in parentheses immediately following the 
array or matrix variable. For example, A(ROW), A(l), A(X +1). 


var Variable: Any variable. May be mvar, avar, or svar. 


aop Arithmetic operator. 

lop Logical operator. 

aexp Arithmetic Expression: Generally composed of a variable, 

function, constant, or two arithmetic expressions separated by an 
arithmetic operator. 

lexp Logical Expression: Generally composed of two arithmetic or 

string expressions separated by a logical operator. Such an ex¬ 
pression evaluates to either a 1 (logical true) or a 0 (logical false). 

For example, the expression 1<2 evaluates to the value 1 (true) 
while the expression “LEMON” = “ORANGE” evaluates to a zero 
(false) as the two strings are not equal. 
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Logical Line: A logical line consists of one to three physical lines, and is ter- 
minated either by afjgffiEl or automatically when the maximum logical line 
limit is reached. Each numbered line in a BASIC program consists of one logical 
line when displayed on the screen. When entering a line which is longer than 
one physical line, the Cursor will automatically go to the beginning of the next 
physical line when the end of the current physical line is reached. If ( 
not entered, then both physical lines will be part of the same logical line. 


Operator: Operators are used in expressions. Operators include addition (+), 
subtraction (-), multiplication ( * ), division (/), exponentiatinn (A), greater than 
(>), less than (<), equal to(=), greater than orequal to(>=), less thanorequal to 
(< =), and not equal to (<>). The logical keywords AND, NOT and OR are also 
operators. The + and - operators can also be used as unary operators; e.g., -3. 

Do not put several unary operators in a row; e.g.,-3, as the Computer will in- 

terpret it incorrectly. 

Physical Line: One line of characters as displayed on a television screen. 


String: A string is a group of characters enclosed in quotation marks. 
“ABRACADABRA” is a string. So are “ATARI MAKES GREAT COMPUTERS” 
and “123456789”. A string is much like a constant, as it too, may be stored in a 
variable. A string variable is different, in that its name must end in the 
character $. For example, the string “ATARI 800” may be assigned to a variable 


called A$ using (optional) LET like this: 


19 LET A$="ATARI 393” 

(note quotation marks) 

OR 


10 A$= 11 ATARI 800 !! 

(LET is optional; the 


quotes are required.) 


Quotation marks may not be used within a string. However, the closing quota¬ 
tion can be omitted if it is the last character on a logical line. (See Section 7 - 

STRINGS). 

Variable: A variable is the name for a numerical or other quantity which may 
(or may not) change. Variable names may be up to 120 characters long. 
However, a variable name must Start with an alphabetic letter, and may contain 
only Capital letters and numerical digits. It is advisable not to use a keyword as a 
variable name or as the first part of a variable name as it may not be interpreted 
correctly. Examples of storing a value in a variable: 

LETC123DUB=1.234 
LETUARIABLEI 12=267.543 
LETh=1 
LETF5TH=6.5 
LETTHISNO = 59.889 

Note: LET is optional and may be omitted) 


Variable Name Limit: ATARI BASIC limits the user to 128 variable names.To 
bypass this problem, use individual elements of an array instead of having 
separate variable names. BASIC keeps all references to a variable which has 
been deleted from a program, and the name still remains in the variable name 
table. 
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ERROR CODES 


ERROR 

ERROR 

CODE ERROR CODE MESSAGE 

CODE ERROR CODE MESSAGE 

2 

Memory Insufficient 

142 

Serial Bus Data Frame Overrun 

3 

Value Error 

143 

Serial bus data frame checksum error 

4 

Too Many Variables 

144 

Device done error 

5 

String Length Error 

145 

Read after write compare error 

6 

Out of Data Error 

14G 

Function not implemented 

7 

Number greater than 32767 

147 

Insufficient RAM 

8 

Input Statement Error 

IGO 

Drive number error 

9 

Array or String DIM Error 

161 

Too many OPEN flies 

10 

Argument Stack Overflow 

162 

Disk full 

11 

Floating Point Overflow/ 

163 

Unrecoverable System data I/O error 


Underflow Error 

164 

File number mismatch 

12 

Line Not Found 

165 

File name error 

13 

No Matching FÜR Statement 

166 

POINT data length error 

14 

Line Too Long Error 

167 

File locked 

15 

GOSUB or FOR Line Deleted 

168 

Command invalid 

IG 

RETURN Error 

169 

Directory full 

17 

Garbage Error 

170 

File not found 

18 

Invalid String Character 

171 

POINT invalid 

Note: 

The following are INPUT/OUTPUT er- 



rors that result during the use of disk drives, 
printers, or other accessory devices. Further In¬ 
formation is provided with the auxiliary hard- 



wäre. 




19 

LOAD program Too Long 



20 

Device Number Larger 



21 

LOAD File Error 



128 

BREAK Abort 



129 

IOCB 



130 

Nonexistent Device 



131 

IOCB Write Only 



132 

Invalid Command 



133 

Device or File not Open 



134 

BAD IOCB Number 



135 

IOCB Read Only Error 



136 

EOF 



137 

Truncated Record 



138 

Device Timeout 



139 

Device NAK 



140 

Serial Bus 



141 

Cursor Out of Range 

For explanation of Error Messages see Appendix B. 



